Repository navigation
Spawn v1.0.4
v1.0.4 — AGENTS.md / CLAUDE.md Generation
Every project Spawn generates now ships an AGENTS.md file alongside its README.md — orienting coding agents (Claude Code and others) on project structure, setup, and conventions from the moment the project exists.
Added
-
AGENTS.mdGeneration — Automatically generated for every template using shared defaults (uv sync,uv run pytest, conventions) for Automation, CLI, and Data Projects, alongside template-specific overrides: -
Backend API: States the framework and its exact run command.
-
AI Chatbot / AI Agent: States the provider and required environment variables, accounting for framework-specific naming:
-
litellm+ollama$\rightarrow$ OLLAMA_API_BASE(notOLLAMA_BASE_URL) -
openai-agents+openrouter$\rightarrow$ OPENAI_API_KEY+OPENAI_BASE_URL(notOPENROUTER_API_KEY) -
RAG System: States the required
OPENAI_API_KEYand ingestion mechanics. -
MCP Server: Explains how to add tools/resources via the
mcpSDK decorator API. -
Custom Structure Support — Generates
AGENTS.mdonly if included in the user's pasted structure (matchingREADME.mdand.gitignorebehavior). -
--claude-md/--no-claude-mdFlags — Opt-in generation of an identicalCLAUDE.mdfile alongsideAGENTS.md(supported via CLI flag, interactive prompt, and"claude_md"config file key; off by default). -
spawn doctorCheck — Now checks forAGENTS.mdunder Recommended-tier Documentation items.
Compatibility
- Fully backward compatible. Existing templates and workflows remain unchanged.
Verification
- 916 tests passing. Verified end-to-end across:
--configJSON opt-in flow- Interactive Custom Structure opt-in (confirmed byte-identical output between
AGENTS.mdandCLAUDE.md) - Non-standard environment variable provider/framework mappings