# Uchiha Agent Space Installation

**Organization:** Uchiha
**Project:** Uchiha
**Space Type:** Agent Space (智能体空间)

## Overview
This document provides instructions for installing and setting up the Uchiha Agent Space within the Uchiha organization's Uchiha project. The Agent Space provides an intelligent workspace environment for AI-assisted development, leveraging the ASDM platform's toolsets and specs to enable agentic workflows.

## AI Guided Installation
To install this agent space using AI Guided Installation, copy and paste the following prompt into your AI Coding tool's chat window:

```shell
Follow instructions in .workspace/INSTALL.md
```

## Installation Steps

### 1. Verify Organization and Project Context

Confirm that you are working within the correct organization and project hierarchy:

- **Organization:** Uchiha
- **Project:** Uchiha (under the Uchiha organization)
- **Space:** Agent Space (智能体空间) - the current workspace for AI-assisted development

Verify the workspace structure exists:
```bash
ls -la .asdm/
ls -la .workspace/
```

### 2. Verify ASDM Platform Setup

Ensure the ASDM platform is properly initialized in the workspace:

```bash
# Verify workspace install configuration
cat .asdm/workspace-install.json

# Verify installed toolsets
ls -la .asdm/toolsets/

# Verify installed specs
ls -la .asdm/specs/
```

The workspace should contain at minimum:
- **Toolsets:** `basic-tools`, `context-builder`
- **Specs:** `code-review`

### 3. Detect the Current `Agentic Engine` Provider

Detect the current AI coding assistant provider (e.g., Claude Code, GitHub Copilot, Tencent CodeBuddy). Using the following guidelines to detect the provider:

- If `.claude` directory exists, use `Claude Code`
- If `.github` directory exists, use `GitHub Copilot`
- If `.codebuddy` directory exists, use `Tencent CodeBuddy`
- If no such folder is found in the current workspace, give user a prompt to select a provider manually

### 4. Verify Shortcut Commands for Toolsets

Ensure that shortcut commands for installed toolsets are available in the provider's entry point:

#### For Tencent CodeBuddy (`.codebuddy/commands/`):
```bash
ls -la .codebuddy/commands/

# Expected commands:
# - asdm-context-build.md
# - asdm-context-update.md
# - asdm-start-project.md
# - asdm-git-commit-message.md
# - asdm-git-commit.md
```

#### For Claude Code (`.claude/commands/`):
```bash
ls -la .claude/commands/
```

#### For GitHub Copilot (`.github/prompts/`):
```bash
ls -la .github/prompts/
```

### 5. Create Agent Space Configuration

Create the agent space configuration file in the `.workspace` directory:

```bash
cat > .workspace/agent-space.json << 'EOF'
{
  "version": 1,
  "organization": "Uchiha",
  "project": "Uchiha",
  "spaceType": "agent-space",
  "spaceName": "智能体空间",
  "provider": "<detected-provider>",
  "toolsetIds": [
    "basic-tools",
    "context-builder"
  ],
  "specIds": [
    "code-review"
  ],
  "createdAt": "<current-date>",
  "updatedAt": "<current-date>"
}
EOF
```

Replace `<detected-provider>` with the provider detected in Step 3, and `<current-date>` with the current ISO 8601 date string.

### 6. Initialize Context for the Agent Space

After installation, initialize the context for the workspace:

```shell
Follow the instructions in .asdm/toolsets/context-builder/actions/asdm-context-build.md
```

This will:
1. Analyze the Uchiha project workspace structure and technology stack
2. Generate comprehensive context files in `.asdm/contexts/` directory
3. Create an index and guide for AI models to understand the workspace
4. Ground the agent space context to the Uchiha project codebase

## Available Commands

Once the agent space is installed and initialized, you can use the following commands:

### Basic Tools (Toolset ID: `basic-tools`)
1. **`/asdm-start-project`** - Start the Uchiha project in development mode
2. **`/asdm-git-commit-message`** - Generate a standard git commit message for changes
3. **`/asdm-git-commit`** - Commit changes with the generated commit message

### Context Builder (Toolset ID: `context-builder`)
4. **`/asdm-context-build`** - Generate initial context for the Uchiha workspace
5. **`/asdm-context-update`** - Update existing context when the workspace changes

## Agent Space Workflow

The typical workflow within the Uchiha Agent Space follows these steps:

1. **Initialize Context** - Build workspace context using `/asdm-context-build`
2. **Start Project** - Launch the project in development mode using `/asdm-start-project`
3. **Develop** - Make changes to the codebase with AI assistance
4. **Update Context** - When significant changes are made, update context using `/asdm-context-update`
5. **Commit Changes** - Generate and commit changes using `/asdm-git-commit-message` and `/asdm-git-commit`

## Verification

After installation, verify that:

1. The `.workspace/agent-space.json` configuration file exists with correct organization, project, and space type settings
2. The ASDM platform is properly configured (`.asdm/workspace-install.json` exists)
3. Toolsets are installed (`basic-tools`, `context-builder` in `.asdm/toolsets/`)
4. Specs are available (`code-review` in `.asdm/specs/`)
5. Shortcut commands are available in the appropriate provider directory
6. Context files have been generated in `.asdm/contexts/`

## Directory Structure

After successful installation, the workspace directory structure should be:

```
.
├── .asdm/
│   ├── workspace-install.json
│   ├── toolsets/
│   │   ├── basic-tools/
│   │   │   ├── manifest.json
│   │   │   ├── INSTALL.md
│   │   │   ├── README.md
│   │   │   ├── actions/
│   │   │   └── spec/
│   │   └── context-builder/
│   │       ├── manifest.json
│   │       ├── INSTALL.md
│   │       ├── README.md
│   │       ├── actions/
│   │       └── specs/
│   ├── specs/
│   │   └── code-review/
│   │       ├── manifest.json
│   │       └── README.md
│   └── contexts/
│       └── (generated context files)
├── .workspace/
│   ├── INSTALL.md
│   └── agent-space.json
├── .codebuddy/ (or .claude/ or .github/)
│   └── commands/ (or prompts/)
│       ├── asdm-context-build.md
│       ├── asdm-context-update.md
│       ├── asdm-start-project.md
│       ├── asdm-git-commit-message.md
│       └── asdm-git-commit.md
└── (project source files)
```

## Notes

- This installation process assumes you have the necessary permissions to create directories and files
- The agent space is configured for the Uchiha organization's Uchiha project
- The actual implementation of the commands will be handled by the AI model using the templates and instructions provided by ASDM toolsets
- Make sure to customize the provider-specific setup based on your actual AI coding assistant
- **For providers not in the detection logic**: Users can manually use the instruction files by copying their relative paths and entering prompts like "Follow the instructions in .asdm/toolsets/basic-tools/actions/asdm-start-project.md"

## Integration with Other Toolsets

The Agent Space can integrate with additional ASDM toolsets beyond the default `basic-tools` and `context-builder`. Additional toolsets can be installed by updating `.asdm/workspace-install.json` and following the respective toolset's INSTALL.md instructions.

### Getting Help
For issues with the Uchiha Agent Space, refer to:
- [ASDM Documentation](https://asdm.ai/docs)
- Toolset READMEs: `.asdm/toolsets/basic-tools/README.md`, `.asdm/toolsets/context-builder/README.md`
- Context files in `.asdm/contexts/`

## License
Copyright (c) 2026 LeansoftX.com & iSoftStone. All rights reserved.

Licensed under the PROPRIETARY SOFTWARE LICENSE. See [LICENSE](LICENSE) in the project root for license information.

---

*This installation document is part of the Uchiha Agent Space under the Uchiha organization's Uchiha project. Use the available commands to perform development tasks within the intelligent workspace environment.*