tx-ai-agent-sdd 0.1.0

CLI scaffold generator for spec-driven AI agent documentation

tx-ai-agent-sdd

tx-ai-agent-sdd bootstraps a spec-driven workspace for AI-assisted software projects. It gives you a ready-to-use documentation skeleton, prompt files, workflow notes, conventions, and input templates.

What the package creates

After installation, tx-ai-agent-sdd init <path> generates:

• docs/ with core artifacts: idea.md, vision.md, HLD.md, LLD.md, and tasklist.md
• .ai/prompts/ with prompt templates for document generation
• .ai/workflows/ for project workflow notes
• .ai/conventions/ for coding and delivery conventions
• inputs/ with example inputs for idea, vision, and user story stages
• README.spec.md with a short workflow guide

Installation

From PyPI:

python -m pip install tx-ai-agent-sdd

From source:

python -m pip install .

Usage

Create a new scaffold:

tx-ai-agent-sdd init my-project

Show the installed CLI version:

tx-ai-agent-sdd --version

Copy the scaffold into an existing non-empty directory:

tx-ai-agent-sdd init my-project --force

Suggested workflow

1. Fill in inputs/idea.input.example.md.
2. Generate docs/idea.md.
3. Use idea.md to produce docs/vision.md.
4. Use a user story and vision.md to produce docs/HLD.md.
5. Use HLD.md to produce docs/LLD.md.
6. Use vision.md, HLD.md, LLD.md, workflows, and conventions to produce docs/tasklist.md.
7. Run subsequent iterations through the workflow protocol.

Why it is useful

This package is a good fit if you want a repeatable way to start AI-assisted projects without rebuilding the same folder structure and document flow every time.