# ASDM Workspace Installation Guide

**Workspace ID:** `44`
**Registry Version:** `mock`
**Last Updated:** 2026-06-29

## Overview

This workspace is configured with the ASDM (AI-Assisted Software Development Management) platform. It includes two toolsets and one spec that provide AI-assisted development capabilities through your Agentic Engine provider.

### Installed Components

| Component | ID | Version | Description |
|-----------|----|---------|-------------|
| Toolset | `basic-tools` | 0.0.2 | Basic tools for AI-assisted software development (git operations, project startup) |
| Toolset | `context-builder` | 0.0.1 | Context builder for grounding AI models to your codebase |
| Spec | `code-review` | 1.0.0 | Code review guidelines and checklist |

## AI Guided Installation

To install this workspace 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. Detect the current Agentic Engine provider

Detect the current AI coding assistant provider using the following guidelines:

- 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, prompt the user to select a provider manually

**Current provider detected:** Tencent CodeBuddy (`.codebuddy` directory exists)

### 2. Ensure `.asdm/contexts` directory exists

The Context Builder toolset requires a directory for storing context files:

```bash
mkdir -p .asdm/contexts
```

### 3. Install Basic Tools toolset (`basic-tools`)

Create shortcut commands for Basic Tools in the provider's entry point.

#### For Tencent CodeBuddy (`.codebuddy/commands/`):

```bash
mkdir -p .codebuddy/commands/

# Copy instruction files directly (no frontmatter needed)
cp .asdm/toolsets/basic-tools/actions/asdm-start-project.md .codebuddy/commands/
cp .asdm/toolsets/basic-tools/actions/asdm-git-commit-message.md .codebuddy/commands/
cp .asdm/toolsets/basic-tools/actions/asdm-git-commit.md .codebuddy/commands/
```

#### For Claude Code (`.claude/commands/`):

```bash
mkdir -p .claude/commands/

# Start Project command
cat > .claude/commands/asdm-start-project.md << 'EOF'
---
description: "Detect workspace context and start the project in development mode"
argument-hint: "[optional: specific environment]"
---

EOF
cat .asdm/toolsets/basic-tools/actions/asdm-start-project.md >> .claude/commands/asdm-start-project.md

# Generate Git Commit Message command
cat > .claude/commands/asdm-git-commit-message.md << 'EOF'
---
description: "Generate a standard git commit message based on current changes"
argument-hint: "[optional: custom scope or context]"
---

EOF
cat .asdm/toolsets/basic-tools/actions/asdm-git-commit-message.md >> .claude/commands/asdm-git-commit-message.md

# Git Commit command
cat > .claude/commands/asdm-git-commit.md << 'EOF'
---
description: "Commit changes to the current branch with generated commit message"
argument-hint: "[optional: specific files to commit]"
---

EOF
cat .asdm/toolsets/basic-tools/actions/asdm-git-commit.md >> .claude/commands/asdm-git-commit.md
```

#### For GitHub Copilot (`.github/prompts/`):

```bash
mkdir -p .github/prompts/

# Start Project prompt
cat > .github/prompts/asdm-start-project.prompt.md << 'EOF'
---
agent: 'agent'
description: 'Detect workspace context and start the project in development mode'
argument-hint: 'Enter optional environment or leave blank'
---

EOF
cat .asdm/toolsets/basic-tools/actions/asdm-start-project.md >> .github/prompts/asdm-start-project.prompt.md

# Generate Git Commit Message prompt
cat > .github/prompts/asdm-git-commit-message.prompt.md << 'EOF'
---
agent: 'agent'
description: 'Generate a standard git commit message based on current changes'
argument-hint: 'Enter optional scope or context'
---

EOF
cat .asdm/toolsets/basic-tools/actions/asdm-git-commit-message.md >> .github/prompts/asdm-git-commit-message.prompt.md

# Git Commit prompt
cat > .github/prompts/asdm-git-commit.prompt.md << 'EOF'
---
agent: 'agent'
description: 'Commit changes to the current branch with generated commit message'
argument-hint: 'Enter optional specific files to commit'
---

EOF
cat .asdm/toolsets/basic-tools/actions/asdm-git-commit.md >> .github/prompts/asdm-git-commit.prompt.md
```

### 4. Install Context Builder toolset (`context-builder`)

Create shortcut commands for Context Builder in the provider's entry point.

#### For Tencent CodeBuddy (`.codebuddy/commands/`):

```bash
mkdir -p .codebuddy/commands/

# Copy instruction files directly (no frontmatter needed)
cp .asdm/toolsets/context-builder/actions/asdm-context-build.md .codebuddy/commands/
cp .asdm/toolsets/context-builder/actions/asdm-context-update.md .codebuddy/commands/
```

#### For Claude Code (`.claude/commands/`):

```bash
mkdir -p .claude/commands/

# Context Build command
cat > .claude/commands/asdm-context-build.md << 'EOF'
---
description: "Generate initial context for the workspace"
argument-hint: "[additional prompt]"
---

EOF
cat .asdm/toolsets/context-builder/actions/asdm-context-build.md >> .claude/commands/asdm-context-build.md

# Context Update command
cat > .claude/commands/asdm-context-update.md << 'EOF'
---
description: "Update existing context when workspace changes"
argument-hint: "[additional prompt]"
---

EOF
cat .asdm/toolsets/context-builder/actions/asdm-context-update.md >> .claude/commands/asdm-context-update.md
```

#### For GitHub Copilot (`.github/prompts/`):

```bash
mkdir -p .github/prompts/

# Context Build prompt
cat > .github/prompts/asdm-context-build.prompt.md << 'EOF'
---
agent: 'agent'
description: 'Generate initial context for the workspace'
argument-hint: 'Enter additional prompt'
---

EOF
cat .asdm/toolsets/context-builder/actions/asdm-context-build.md >> .github/prompts/asdm-context-build.prompt.md

# Context Update prompt
cat > .github/prompts/asdm-context-update.prompt.md << 'EOF'
---
agent: 'agent'
description: 'Update existing context when workspace changes'
argument-hint: 'Enter additional prompt'
---

EOF
cat .asdm/toolsets/context-builder/actions/asdm-context-update.md >> .github/prompts/asdm-context-update.prompt.md
```

## Initializing the Workspace

After installation, initialize the workspace by generating context and starting the project.

### Step 1: Generate Initial Context

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

Or use the slash command:

```
/asdm-context-build
```

This will:
1. Analyze your 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 your workspace

### Step 2: Start the Project

```shell
Follow the instructions in .asdm/toolsets/basic-tools/actions/asdm-start-project.md
```

Or use the slash command:

```
/asdm-start-project
```

This will:
1. Detect the current workspace context
2. Analyze the workspace structure and project configuration
3. Identify the project type (Node.js, Java, Python, etc.)
4. Install dependencies if needed
5. Start the development server or application
6. Provide feedback on the startup status

## Available Commands

Once installed, the following slash commands are available:

### Basic Tools (`basic-tools`)

| Command | Description |
|---------|-------------|
| `/asdm-start-project` | Start the project in development mode |
| `/asdm-git-commit-message` | Generate a standard git commit message based on current changes |
| `/asdm-git-commit` | Commit changes with the generated commit message |

### Context Builder (`context-builder`)

| Command | Description |
|---------|-------------|
| `/asdm-context-build` | Generate initial context for the workspace |
| `/asdm-context-update` | Update existing context when workspace changes |

## Context Files Structure

The Context Builder will create the following files in `.asdm/contexts/`:

| File | Description |
|------|-------------|
| `index.md` | Workspace index and guide for AI models |
| `standard-project-structure.md` | Standard project structure |
| `standard-coding-style.md` | Coding standards and style guidelines |
| `data-models.md` | Data models and relationships |
| `deployment.md` | Deployment configuration and processes |
| `api.md` | API definitions and documentation |
| `architecture.md` | System architecture and design decisions |

## Spec Documents

### Code Review (`code-review`)

The code review spec provides guidelines for reviewing code changes:

- Code style and formatting
- Logic correctness
- Error handling
- Performance considerations

Refer to `.asdm/specs/code-review/README.md` for full details.

### Basic Tools Specs

The Basic Tools toolset includes the following spec documents:

- **`git-commit-message-spec.md`** - Template for generating standard git commit messages
- **`git-commit-spec.md`** - Template for committing changes with generated messages

These are located in `.asdm/toolsets/basic-tools/spec/`.

## Verification

After installation, verify the following:

1. `.asdm/contexts` directory exists for Context Builder's workspace
2. Shortcut commands are created in the provider directory:
   - **Tencent CodeBuddy:** `.codebuddy/commands/` contains all 5 command files
   - **Claude Code:** `.claude/commands/` contains all 5 command files with frontmatter
   - **GitHub Copilot:** `.github/prompts/` contains all 5 prompt files with frontmatter
3. Toolset files are intact:
   - `.asdm/toolsets/basic-tools/` (toolset ID: `basic-tools`)
   - `.asdm/toolsets/context-builder/` (toolset ID: `context-builder`)
4. Spec files are intact:
   - `.asdm/specs/code-review/` (spec ID: `code-review`)

## Manual Usage for Other Providers

If your AI coding assistant provider is not among the detected ones (Claude Code, GitHub Copilot, Tencent CodeBuddy), you can manually use the instruction files:

1. Navigate to the instruction files:
   ```bash
   # Basic Tools
   cd .asdm/toolsets/basic-tools/actions/

   # Context Builder
   cd .asdm/toolsets/context-builder/actions/
   ```

2. Copy the relative path of the desired instruction file

3. Enter a prompt in your AI coding assistant:
   ```
   Follow the instructions in {relative path to instruction file}
   ```

## Usage Workflow

### Daily Development Workflow

```
1. /asdm-start-project          → Start the project in development mode
2. Make changes to the codebase
3. /asdm-git-commit-message     → Generate a commit message for your changes
4. /asdm-git-commit             → Commit the changes
```

### Context Management Workflow

```
1. /asdm-context-build          → Generate initial context (first time or major changes)
2. /asdm-context-update         → Update context after significant workspace changes
```

## Integration with Other Toolsets

- **Basic Tools** provides foundational git operations that are commonly needed throughout any development process
- **Context Builder** can be used as a provider for other toolsets through **context injection** — other toolsets can reference the context files to ground generated content to the codebase

## Getting Help

For issues with the installed toolsets, refer to:

- [ASDM Documentation](https://asdm.ai/docs)
- Basic Tools README: `.asdm/toolsets/basic-tools/README.md`
- Basic Tools INSTALL: `.asdm/toolsets/basic-tools/INSTALL.md`
- Context Builder README: `.asdm/toolsets/context-builder/README.md`
- Context Builder INSTALL: `.asdm/toolsets/context-builder/INSTALL.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 covers the ASDM workspace configuration for workspace ID `44`. It combines the installation instructions for the `basic-tools` and `context-builder` toolsets along with the `code-review` spec.*