Skip to content

docs: add spec engineering agent prompt#14

Merged
arnaudlewis merged 1 commit into
mainfrom
docs/spec-agent
Mar 28, 2026
Merged

docs: add spec engineering agent prompt#14
arnaudlewis merged 1 commit into
mainfrom
docs/spec-agent

Conversation

@arnaudlewis

Copy link
Copy Markdown
Owner

Summary

  • Add docs/spec-agent.md — a ready-to-use AI agent prompt for spec-driven development with minter
  • Designed as dual-use: readable documentation AND drop-in .claude/agents/spec.md file
  • Agent delegates all domain knowledge to the MCP (grammar, smells, NFR design, granularity) and focuses on behavioral methodology (operating modes, confidence tracking, adversarial assessment, teaching)
  • Add install instructions to getting-started.md (one-liner curl)
  • Add entry to docs/README.md index

Agent capabilities

  • 4 operating modes: greenfield, inference from code, assessment, refinement
  • Confidence tracking (stated/inferred/suggested)
  • Multi-spec coordination with dependency ordering
  • Version discipline (patch/minor/major)
  • Teaching while working (explains reasoning to help developers learn)
  • Anti-pattern prevention

Test plan

  • Copy to .claude/agents/spec.md and verify it works with minter MCP
  • Verify curl one-liner downloads correctly
  • Review agent behavior in a real spec authoring session

🤖 Generated with Claude Code

@arnaudlewis arnaudlewis force-pushed the docs/spec-agent branch 2 times, most recently from 9c8fd58 to 22c6403 Compare March 28, 2026 21:18
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@arnaudlewis arnaudlewis merged commit c681a36 into main Mar 28, 2026
4 checks passed
@arnaudlewis arnaudlewis deleted the docs/spec-agent branch March 28, 2026 21:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant