This folder contains the documentation source files for Spec Kit, built using DocFX.

To build the documentation locally:

1. Install DocFX:

   dotnet tool install -g docfx

2. Build the documentation:

   cd docs
   docfx docfx.json --serve

3. Open your browser to http://localhost:8080 to view the documentation.

• docfx.json - DocFX configuration file
• index.md - Main documentation homepage
• toc.yml - Table of contents configuration
• installation.md - Installation guide
• quickstart.md - Spec-Driven Development walkthrough
• guides/agentic-sdlc.md - How Spec Kit applies agentic and conventional SDLC practices to itself
• guides/bugfix.md - Bug-fixing walkthrough
• guides/assessment.md - Idea assessment walkthrough
• guides/customization.md - Choosing and combining customization building blocks
• reference/catalogs.md - Catalog discovery, trust, private sources, and precedence
• reference/agentic-*.md - Detailed process command references
• _site/ - Generated documentation output (ignored by git)

Documentation is automatically built and deployed to GitHub Pages when changes are pushed to the main branch. The workflow is defined in .github/workflows/docs.yml.