User-facing documentation for the AI-SDLC Framework.
Source of truth. This directory (
ai-sdlc/docs/) is the canonical source for all user-facing documentation. The published site atai-sdlc-io/content/docs/is generated from these.mdfiles viapnpm docs:sync(scripts/docs-sync.mjs). Always edit here, never directly inai-sdlc-io.CI catches drift via
pnpm docs:check(scripts/check-docs-sync.mjs). Seebacklog/decisions/AISDLC-68-documentation-consolidation.mdfor the architecture decision.
| Section | Description |
|---|---|
| Getting Started | Installation, CLI quick start, first pipeline |
| Tutorials | Step-by-step walkthroughs (5 tutorials) |
| API Reference | Complete SDK and orchestrator reference |
| Examples | Runnable TypeScript and YAML examples |
| Architecture | Package structure, data flow, design decisions |
| Operations | Operator runbooks, execution paths, and production triage — see Operations index for the full navigation map |
| Troubleshooting | FAQ, common errors, environment variables |
- New to AI-SDLC? Start with Getting Started for installation and CLI quick start.
- Configuring agent runners? See the Runners Reference for all supported agents.
- Building with the SDK? See the API Reference for types, functions, and examples.
- Learning the concepts? Read the Primer for a conceptual introduction.
- Implementing a spec? The Specification contains the full normative requirements.
The normative specification lives in spec/. These docs are informative guides aimed at implementors and end users.
Apache-2.0