# ASDM Workspace

> AI-assisted Software Development Management Platform Workspace

## What is ASDM?

ASDM (AI-assisted Software Development Management) is a platform for managing AI-assisted software development. It provides a structured system of **toolsets** and **specs** that define instructions, templates, and workflows for AI coding assistants (such as Claude Code, GitHub Copilot, and Tencent CodeBuddy) to follow when working with software projects.

ASDM acts as a meta-tool -- it does not contain application source code itself; instead, it provides the scaffolding and configuration that enables AI agents to understand, build context about, and operate on other software projects.

## Workspace Overview

This workspace (ID: `35`) is configured with the following components:

| Component | ID | Version | Description |
|-----------|----|---------|-------------|
| **Toolset** | `basic-tools` | 0.0.2 | Basic git operations and project startup |
| **Toolset** | `context-builder` | 0.0.1 | Building workspace context for AI models |
| **Spec** | `code-review` | 1.0.0 | Code review guidelines and checklist |

## Directory Structure

```
.asdm/
├── workspace-install.json          # Master registry of all workspaces, toolsets, and specs
├── specs/
│   └── code-review/                # Code review spec
│       ├── manifest.json
│       └── README.md
├── toolsets/
│   ├── basic-tools/                # Basic tools for daily git operations
│   │   ├── manifest.json
│   │   ├── README.md
│   │   ├── INSTALL.md
│   │   ├── actions/                # AI agent executable instructions
│   │   │   ├── asdm-start-project.md
│   │   │   ├── asdm-git-commit.md
│   │   │   └── asdm-git-commit-message.md
│   │   └── spec/                   # Reference templates for actions
│   │       ├── git-commit-message-spec.md
│   │       └── git-commit-spec.md
│   └── context-builder/            # Context builder for workspace understanding
│       ├── manifest.json
│       ├── README.md
│       ├── INSTALL.md
│       ├── actions/
│       │   ├── asdm-context-build.md
│       │   └── asdm-context-update.md
│       └── specs/                  # Template specs for context generation
│           ├── index.md
│           ├── standard-project-structure.md
│           ├── standard-coding-style.md
│           ├── data-models.md
│           ├── deployment.md
│           ├── api.md
│           └── architecture.md
.codebuddy/
└── commands/                       # CodeBuddy slash command shortcuts
    ├── asdm-start-project.md
    ├── asdm-git-commit.md
    ├── asdm-git-commit-message.md
    ├── asdm-context-build.md
    └── asdm-context-update.md
.workspace/                         # Workspace metadata placeholder
```

## Core Concepts

### Toolset

A bundle of AI-agent instructions organized into:

- **Actions**: Markdown instruction files that AI agents execute when invoked via slash commands. These are the "executable" part of ASDM.
- **Specs**: Template/specification documents that define standards and formats. Specs serve as reference material that actions can draw upon.

### Spec

A standalone specification (not part of a toolset) that defines guidelines, e.g. code review checklist.

### Context

Generated documentation about a workspace stored in `.asdm/contexts/`. Context provides AI models with the necessary information to understand the workspace, including project structure, coding style, data models, APIs, architecture, and deployment details. Context is built by the `context-builder` toolset and consumed by other toolsets via **context injection**.

## Available Commands

The following slash commands are available for CodeBuddy:

| Command | Description |
|---------|-------------|
| `/asdm-start-project` | Detect workspace context and start the project in development mode |
| `/asdm-git-commit-message` | Generate a standard git commit message (Conventional Commits format) |
| `/asdm-git-commit` | Commit changes with the generated commit message |
| `/asdm-context-build` | Build initial context for the current workspace |
| `/asdm-context-update` | Update existing context when the workspace changes |

## Quick Start

### 1. Install a Toolset

Copy and paste the following prompt into your AI coding tool's chat window:

```shell
Follow instructions in .asdm/toolsets/basic-tools/INSTALL.md
```

or

```shell
Follow instructions in .asdm/toolsets/context-builder/INSTALL.md
```

### 2. Build Workspace Context

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

### 3. Use Daily Commands

Use the slash commands listed above for daily git operations and context management.

## Architecture Workflow

1. **Installation** -- The AI agent detects the provider (CodeBuddy, Claude Code, etc.), copies action files to the provider's command directory, and sets up the workspace structure.
2. **Context Building** -- The user invokes `/asdm-context-build`. The AI agent analyzes the workspace and generates customized context files in `.asdm/contexts/`.
3. **Context Injection** -- Other toolsets reference the context files when executing their actions, enabling AI models to work with full workspace understanding.
4. **Daily Operations** -- Use `/asdm-git-commit-message` and `/asdm-git-commit` for standard git workflow.

## Supported AI Providers

ASDM supports multiple AI coding assistant providers:

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

## Documentation

- ASDM Documentation: [https://asdm.ai/docs](https://asdm.ai/docs)
- Context Injection Concept: [https://asdm.ai/docs/concepts/context-injection](https://asdm.ai/docs/concepts/context-injection)

## Copyright & License

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

Licensed under the PROPRIETARY SOFTWARE LICENSE.