Manufacturing Track Bases

Per-course starting environments for the Manufacturing track of The AI Agent Factory.

Each folder here is the base for one crash course: rules files, MCP wiring, and an env template. On this track you direct, and your coding agent builds the project on top of the base from prompts you paste. Each course's Quick Win walks you through it, and your agent does the setup itself.

The bases share one spine: Neon and Context7 over MCP, database work through Neon MCP only (dev-plane), audit in the same transaction, and skills the agent installs (skill-creator, mcp-builder, plus whatever a course needs). They differ in that skill set, which is why each course gets its own folder. The Paperclip base is the exception: Paperclip ships its own embedded Postgres and is driven through its CLI and REST API, so that base has no Neon, no Context7, and no .mcp.json; the skills it installs are Paperclip's own operator skills (paperclip-create-agent, diagnose-why-work-stopped). The Eval-Driven Development base adds one more spine member: a local, keyless phoenix MCP (@arizeai/phoenix-mcp against http://localhost:6006) alongside Neon and Context7, dormant until the course launches Phoenix.

How a base is used

Open a course folder in your coding agent (Claude Code or OpenCode). CLAUDE.md loads AGENTS.md, which carries the standing rules and tells the agent how to install the course's skills and confirm the MCP servers. Then follow the course.

Reference solutions

The worked-examples/ folder holds the finished build for a course, for after you have done it yourself. These are full reference solutions (the complete code, verified end to end), not bare bases, so they are deliberately kept out of the release zips. Treat them as the answer key: read them when you are stuck or want to compare, not as your starting point.

Adding a course

Add a folder with the base files (copy an existing one, adjust AGENTS.md's skill list and .mcp.json if the course needs another server). On the next v* tag, CI builds <folder>-base.zip and attaches it to the Release.

License

Apache-2.0.