Contributing

Thanks for your interest in themarch/dev! Skills, templates, and MCP servers are all pluggable — adding one is the canonical way to contribute.

See the root CONTRIBUTING.md for the formal contributor guide. This page focuses on the three “extend the catalog” workflows.

Add a skill

1. mkdir -p packages/skills/catalog/<name>/templates
2. Write SKILL.md with the required frontmatter (see skills.md).
3. Add Handlebars templates.
4. Add <name> to EXPECTED_SKILLS in packages/skills/tests/catalog.test.ts.
5. Run pnpm test.

Add a template

1. mkdir templates/<name>
2. Write a manifest.json (name, displayName, description, features[], postInit).
3. Add files (any .hbs is rendered with { projectName, features } in scope).
4. Add a smoke test in packages/cli/tests/<name>-smoke.test.ts.

Add an MCP server

1. mkdir packages/mcp-servers/mcp-<name> with package.json, tsconfig.json, tsup.config.ts.
2. Implement src/index.ts using @modelcontextprotocol/sdk (see existing servers for the pattern).
3. Register a known-server entry in packages/cli/src/commands/mcp.ts if you want themarch mcp add <name> to work.

Local development

pnpm install
pnpm exec turbo run build test lint

When working on the CLI, set THEMARCH_HOME=$(pwd) so the binary resolves the local templates / catalog instead of the bundled ones.