# ASDM Workspace

> AI-assisted Software Development Methodology Workspace Configuration

## Overview

This workspace is an **ASDM (AI-assisted Software Development Methodology)** configuration project. It provides a structured set of toolsets, specs, and commands that enable AI coding assistants (Claude Code, GitHub Copilot, Tencent CodeBuddy) to work effectively with software projects.

ASDM acts as a "meta-tooling" layer that sits between an AI coding assistant and an actual software project, providing standardized workflows for common development operations such as git commits, context building, and code review.

**Created by**: LeansoftX.com & iSoftStone
**Documentation**: https://asdm.ai/docs

## Workspace Structure

```
.asdm/
├── workspace-install.json        # Master workspace registry
├── contexts/                     # Generated context files (populated after context-build)
├── specs/
│   └── code-review/              # Code review spec
│       ├── README.md             # Review checklist
│       └── manifest.json         # Spec manifest (v1.0.0)
└── toolsets/
    ├── basic-tools/              # Basic development tools (v0.0.2)
    │   ├── README.md
    │   ├── INSTALL.md
    │   ├── manifest.json
    │   ├── actions/              # Action commands
    │   │   ├── asdm-start-project.md
    │   │   ├── asdm-git-commit.md
    │   │   └── asdm-git-commit-message.md
    │   └── spec/                 # Specification templates
    │       ├── git-commit-message-spec.md
    │       └── git-commit-spec.md
    └── context-builder/          # Context building toolset (v0.0.1)
        ├── README.md
        ├── INSTALL.md
        ├── manifest.json
        ├── actions/
        │   ├── asdm-context-build.md
        │   └── asdm-context-update.md
        └── specs/                # Context templates
            ├── index.md
            ├── standard-project-structure.md
            ├── standard-coding-style.md
            ├── data-models.md
            ├── deployment.md
            ├── api.md
            └── architecture.md
.codebuddy/                       # Tencent CodeBuddy integration
└── commands/                     # Slash commands
    ├── asdm-start-project.md     # /asdm-start-project
    ├── asdm-git-commit-message.md # /asdm-git-commit-message
    ├── asdm-git-commit.md        # /asdm-git-commit
    ├── asdm-context-build.md     # /asdm-context-build
    └── asdm-context-update.md    # /asdm-context-update
```

## Installed Toolsets

| Toolset | ID | Version | Description |
|---------|-----|---------|-------------|
| Basic Tools | `basic-tools` | 0.0.2 | Basic tools for AI-assisted development, including git operations |
| Context Builder | `context-builder` | 0.0.1 | Build and manage workspace context for AI models |

## Installed Specs

| Spec | ID | Version | Description |
|------|-----|---------|-------------|
| Code Review | `code-review` | 1.0.0 | Code review guidelines and checklist |

## Available Commands

The following slash commands are registered for the current AI provider:

| Command | Description |
|---------|-------------|
| `/asdm-start-project` | Detect workspace context and start development mode |
| `/asdm-git-commit-message` | Generate a standard conventional commit message |
| `/asdm-git-commit` | Commit changes with the generated commit message |
| `/asdm-context-build` | Build workspace context files from templates |
| `/asdm-context-update` | Update existing workspace context files |

## Multi-Provider Support

ASDM supports multiple AI coding assistant providers:

| Provider | Directory | Format |
|----------|-----------|--------|
| Claude Code | `.claude/commands/` | Markdown with frontmatter |
| GitHub Copilot | `.github/prompts/` | `.prompt.md` with YAML frontmatter |
| Tencent CodeBuddy | `.codebuddy/commands/` | Plain Markdown |

The current workspace is configured for **Tencent CodeBuddy**.

## Key Concepts

- **Toolsets**: Self-contained packages of actions + specs, installable into a workspace. Each has a `manifest.json` registry entry, an `INSTALL.md` for AI-guided setup, and a `README.md`.
- **Context Injection**: The Context Builder generates structured context files (in `.asdm/contexts/`) that other toolsets can reference, grounding AI output to the actual codebase.
- **Workspace Registry**: `workspace-install.json` tracks workspace configurations, installed toolsets, specs, and context IDs.

## Getting Started

1. Install a toolset by following its `INSTALL.md` instructions
2. Build workspace context using `/asdm-context-build`
3. Use available slash commands for daily operations

## Copyright & License

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