# ASDM Workspace

AI-assisted Software Development Management (ASDM) workspace for structured, context-aware, and governed AI coding workflows.

## Overview

This workspace is managed by the ASDM platform, which provides toolsets, specs, and context-generation capabilities for AI coding assistants (e.g., Tencent CodeBuddy, Claude Code, GitHub Copilot). It standardizes how AI assistants interact with your project by injecting relevant context, enforcing coding standards, and automating common workflows.

> **Note:** This workspace (`asdm-workspace-without-repo`) contains the ASDM infrastructure only. Clone your software project into this directory and run `/asdm-context-build` to generate structured context for AI assistants.

## Installed Components

### Toolsets

| Toolset | Version | Commands | Description |
|---------|---------|----------|-------------|
| **context-builder** | 0.0.1 | `asdm-context-build`, `asdm-context-update` | Builds structured context (project structure, coding style, architecture, APIs, data models, deployment) for AI models |
| **basic-tools** | 0.0.2 | `asdm-start-project`, `asdm-git-commit`, `asdm-git-commit-message` | Provides git commit workflow, commit message generation, and project startup actions |

### Specs

| Spec | Version | Description |
|------|---------|-------------|
| **code-review** | 1.0.0 | Code review checklist covering style, logic, error handling, and performance |

## Slash Commands (CodeBuddy)

The following slash commands are available after workspace initialization:

| Command | Purpose |
|---------|---------|
| `/asdm-context-build` | Generate initial structured context for the workspace |
| `/asdm-context-update` | Update existing context after project changes |
| `/asdm-start-project` | Start the project in development mode |
| `/asdm-git-commit` | Perform git commit with AI-generated message |
| `/asdm-git-commit-message` | Generate a conventional commit message |

## Directory Structure

```
.asdm/
  workspace-install.json      # Workspace configuration and history
  toolsets/
    context-builder/          # Context building toolset
      actions/                # AI instruction files
      specs/                  # Context generation templates
    basic-tools/              # Basic development tools
      actions/                # AI instruction files
      spec/                   # Git commit specs
  specs/
    code-review/              # Code review standard definition
  contexts/                   # Generated context output (populated after /asdm-context-build)
.codebuddy/
  commands/                   # CodeBuddy slash command files
.workspace/                   # User project files (clone your repo here)
```

## Quick Start

1. Clone your software project into `.workspace/`
2. Run `/asdm-context-build` to generate structured project context
3. Use `/asdm-start-project` to start the project in dev mode
4. Use `/asdm-git-commit` for standardized git commit workflows
5. Apply `code-review` spec during code reviews for consistent checklist enforcement

## Context Templates

The `context-builder` toolset generates context documents based on these templates:

- **index.md** -- Workspace context index
- **standard-project-structure.md** -- Project structure documentation
- **standard-coding-style.md** -- Coding style and conventions
- **architecture.md** -- System architecture overview
- **api.md** -- API endpoint documentation
- **data-models.md** -- Data model and schema documentation
- **deployment.md** -- Deployment and CI/CD documentation

## Workspace Configuration

- **Active workspace ID:** 35
- **Registry version:** mock
- **Provider:** Tencent CodeBuddy

---

© LeansoftX.com & iSoftStone. All rights reserved.