feat: add LLM-powered generation for extended artifacts (Phase 2)

[suportly]

This implements Phase 2 of the extended artifacts feature, adding automatic LLM-powered generation for all 5 artifact types that were added in Phase 1.

New Features

• ArtifactGenerator Module (src/speckit/core/artifacts.py)

  • generate_data_model() - Generate database schemas from spec and plan
  • generate_research() - Document technology decisions from plan
  • generate_api_contract() - Create API specifications from spec and plan
  • generate_checklist() - Validate specification quality
  • generate_quickstart() - Create developer onboarding guides
  • All methods include async versions

• Jinja2 Prompt Templates (5 new files)

  • templates/data_model.jinja2 - Data model generation prompt
  • templates/research.jinja2 - Research findings generation prompt
  • templates/api_contract.jinja2 - API contract generation prompt
  • templates/checklist.jinja2 - Quality checklist generation prompt
  • templates/quickstart.jinja2 - Quickstart guide generation prompt

• SpecKit Public API (10 new methods)

  • kit.generate_data_model(spec, plan) -> DataModel
  • kit.generate_research(plan) -> ResearchFindings
  • kit.generate_api_contract(spec, plan) -> APIContract
  • kit.generate_checklist(spec) -> QualityChecklist
  • kit.generate_quickstart(spec, plan) -> QuickstartGuide
  • Plus async versions of all methods

Benefits

• Automation: Generate comprehensive artifacts automatically using AI
• Consistency: Follow established patterns from existing workflow methods
• Language Support: All methods support multi-language output (pt-br, es, en)
• Async Support: Full async/await support for parallel generation
• Developer Experience: Simple, intuitive API matching core workflow

Usage Example

from speckit import SpecKit

kit = SpecKit("./my-project")

# Core workflow
spec = kit.specify("Add user authentication")
plan = kit.plan(spec)

# Extended artifacts (automatic generation!)
data_model = kit.generate_data_model(spec, plan)
research = kit.generate_research(plan)
contract = kit.generate_api_contract(spec, plan)
checklist = kit.generate_checklist(spec)
quickstart = kit.generate_quickstart(spec, plan)

# Save all artifacts
kit.storage.save_data_model(data_model, spec.feature_id)
kit.storage.save_research(research, spec.feature_id)
kit.storage.save_api_contract(contract, spec.feature_id)
kit.storage.save_checklist(checklist, spec.feature_id)
kit.storage.save_quickstart(quickstart, spec.feature_id)

Files Changed

• src/speckit/core/artifacts.py (+340 lines) - NEW
• src/speckit/speckit.py (+245 lines) - Updated
• src/speckit/templates/data_model.jinja2 (+70 lines) - NEW
• src/speckit/templates/research.jinja2 (+66 lines) - NEW
• src/speckit/templates/api_contract.jinja2 (+86 lines) - NEW
• src/speckit/templates/checklist.jinja2 (+94 lines) - NEW
• src/speckit/templates/quickstart.jinja2 (+102 lines) - NEW
• PHASE_2_LLM_GENERATION.md (+324 lines) - NEW documentation
• test_extended_artifacts_generation.py (+80 lines) - NEW test

Breaking Changes

None. Fully backward compatible.

Related

• Phase 1: PR feat: add extended artifacts (data-model, research, contracts, checkl… #4 (Extended Artifacts Models)
• Next: Phase 3 (Velospec Platform Integration)

🤖 Generated with Claude Code