# ASDM Workspace

ASDM (AI-assisted Software Development Management) Workspace — a structured toolset and specification framework for AI-assisted software development.

## Overview

This workspace provides standardized toolsets and specs that can be installed into developer workspaces to standardize how AI coding assistants interact with projects. It enables context injection, standardized git operations, and consistent development workflows across different AI providers.

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

## Directory Structure

```
.asdm/
├── workspace-install.json       # Workspace registry & configuration
├── contexts/                    # Generated context files (populated by Context Builder)
├── specs/
│   └── code-review/             # Code review specification & checklist
└── toolsets/
    ├── basic-tools/             # Basic git operation tools
    └── context-builder/         # AI context generation tools
.codebuddy/
└── commands/                    # CodeBuddy slash commands (installed)
.workspace/
└── README.md                    # This file
```

## Installed Toolsets

### Basic Tools (v0.0.2)

Standard git operation shortcuts and specifications for AI-assisted development.

| Command | Description |
|---------|-------------|
| `/asdm-start-project` | Detect workspace context and start project in development mode |
| `/asdm-git-commit-message` | Generate a standardized git commit message |
| `/asdm-git-commit` | Commit changes with a generated commit message |

### Context Builder (v0.0.2)

Automated workspace context generation for AI models. Context files are stored in `.asdm/contexts/` and provide AI models with project structure, coding style, data models, API definitions, deployment info, and architecture details.

| Command | Description |
|---------|-------------|
| `/asdm-context-build` | Build initial context for the current workspace |
| `/asdm-context-update` | Update existing context after workspace changes |

## Installed Specs

| Spec | Description |
|------|-------------|
| `code-review` | Code review checklist covering style, logic, errors, and performance |

## Quick Start

1. **Build context** (recommended first step):
   ```
   /asdm-context-build
   ```

2. **Start project**:
   ```
   /asdm-start-project
   ```

3. **Git operations**:
   ```
   /asdm-git-commit-message    # Generate commit message
   /asdm-git-commit            # Commit with generated message
   ```

## Context Files

When context is generated, the following files are created under `.asdm/contexts/`:

| File | Purpose |
|------|---------|
| `index.md` | Index & guide for AI models to navigate workspace context |
| `standard-project-structure.md` | Project structure documentation |
| `standard-coding-style.md` | Coding style standards |
| `data-models.md` | Data model definitions with Mermaid ER diagrams |
| `deployment.md` | Deployment process & environment documentation |
| `api.md` | API endpoint definitions & testing info |
| `architecture.md` | System architecture with Mermaid diagrams |

## Supported AI Providers

- Claude Code (`.claude/commands`)
- GitHub Copilot (`.github/prompts`)
- Tencent CodeBuddy (`.codebuddy/commands`)

## License

Proprietary Software License. See LICENSE in the project root for details.