# ASDM Workspace

AI-Assisted Software Development Management (ASDM) Workspace — a configuration framework that provides toolsets, specs, and context-building infrastructure for AI coding assistants (Claude Code, GitHub Copilot, Tencent CodeBuddy).

## Overview

This is a **without-repo** workspace, meaning it contains only the ASDM scaffolding and configuration — no application source code. ASDM manages:

- **Toolsets** — collections of AI-guided actions and specifications
- **Specs** — reusable standard documents (e.g., code review checklists)
- **Contexts** — AI-readable documentation about the workspace's codebase

When installed, ASDM creates command shortcuts that AI coding assistants can invoke as slash commands.

## Current Configuration

| Item | Value |
|------|-------|
| Active Workspace ID | 35 |
| Registry Version | mock |

### Installed Toolsets

| Toolset | Version | Commands |
|---------|---------|----------|
| `basic-tools` | 0.0.2 | `/asdm-start-project`, `/asdm-git-commit`, `/asdm-git-commit-message` |
| `context-builder` | 0.0.1 | `/asdm-context-build`, `/asdm-context-update` |

### Installed Specs

| Spec | Version |
|------|---------|
| `code-review` | 1.0.0 |

### Contexts

No contexts have been built yet. Run `/asdm-context-build` to generate workspace context files.

## Directory Structure

```
.
├── .asdm/
│   ├── workspace-install.json          # Workspace installation manifest
│   ├── toolsets/
│   │   ├── basic-tools/                # Git and project startup commands
│   │   │   ├── manifest.json
│   │   │   ├── README.md
│   │   │   ├── INSTALL.md
│   │   │   ├── actions/
│   │   │   │   ├── asdm-start-project.md
│   │   │   │   ├── asdm-git-commit.md
│   │   │   │   └── asdm-git-commit-message.md
│   │   │   └── spec/
│   │   │       ├── git-commit-message-spec.md
│   │   │       └── git-commit-spec.md
│   │   └── context-builder/            # Context generation commands
│   │       ├── manifest.json
│   │       ├── README.md
│   │       ├── INSTALL.md
│   │       ├── actions/
│   │       │   ├── asdm-context-build.md
│   │       │   └── asdm-context-update.md
│   │       └── specs/
│   │           ├── index.md
│   │           ├── architecture.md
│   │           ├── api.md
│   │           ├── data-models.md
│   │           ├── deployment.md
│   │           ├── standard-coding-style.md
│   │           └── standard-project-structure.md
│   ├── specs/
│   │   └── code-review/                # Code review checklist spec
│   │       ├── manifest.json
│   │       └── README.md
│   └── contexts/                       # (empty — run /asdm-context-build)
├── .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/
    └── README.md                       # This file
```

## Available Commands

### Project & Git

| Command | Description |
|---------|-------------|
| `/asdm-start-project` | Detect workspace context and start project in dev mode |
| `/asdm-git-commit` | Commit changes with an AI-generated message |
| `/asdm-git-commit-message` | Generate a conventional commit message from git diff |

### Context Management

| Command | Description |
|---------|-------------|
| `/asdm-context-build` | Generate workspace context files (index first, then additional files on-demand) |
| `/asdm-context-update` | Incrementally update context files when workspace changes |

## Supported AI Coding Assistants

| Provider | Detection | Command Location |
|----------|-----------|------------------|
| Claude Code | `.claude/` directory | `.claude/commands/` |
| GitHub Copilot | `.github/` directory | `.github/copilot/` |
| Tencent CodeBuddy | `.codebuddy/` directory | `.codebuddy/commands/` |

Currently only CodeBuddy commands are installed.

## Getting Started

1. **Build context** — Run `/asdm-context-build` to generate AI-readable documentation about the workspace
2. **Start developing** — Run `/asdm-start-project` to detect workspace context and begin development
3. **Commit changes** — Use `/asdm-git-commit` or `/asdm-git-commit-message` for AI-assisted commits

## Concepts

- **Toolset**: A self-contained package of AI-guided instructions with actions and specs
- **Spec**: A reusable specification document defining standards and templates
- **Context**: AI-readable documentation files generated into `.asdm/contexts/`, covering project structure, coding style, data models, APIs, architecture, and deployment

---

*Powered by ASDM — LeansoftX.com / iSoftStone*