Rebuild Dossier — Claude Code MCP server: rebuild specs
Rebuild Dossier inspects an existing app and creates a specification with contracts and tests for a coding agent to follow. Use it when a rebuild needs explicit behavioral checks instead of guesses.
claude mcp add rebuild-dossier -- npx -y rebuild-dossierWhat Rebuild Dossier does
Rebuild Dossier examines an application's routes, package metadata, build configuration, and existing tests through static analysis. It then gathers uncertain cases for a developer to resolve before producing the rebuild materials. Site inspection uses Playwright, while the initial repository scan runs without an LLM call.
Once every open case has been resolved, the server creates a sibling <repo>-rebuild/ directory containing CLAUDE.md, .claude/rules/, hook settings, contract documents, and test suites. It also runs mutation checks by deliberately changing the original code and checking whether the generated tests catch those changes. The server does not recreate the application itself; a separate coding-agent session consumes the generated materials.
Node 20.12+ is required. The crawl_site tool also needs Chromium installed with npx playwright install chromium. Generated guard hooks block edits to spec/ and contracts that lack test coverage. Shell-command parsing remains heuristic, so writes delegated to a script previously created by the agent can bypass that detection.
What it helps with
- Derive a rebuild specification from an existing codebase
- Collect unresolved questions about application behavior
- Generate contracts and tests for a separate rebuild run
- Check whether generated tests catch deliberate code mutations
- Prevent edits to locked specifications and untested contracts
Example prompts for the agent
- Inspect
/path/to/some-appand collect the unresolved behavior questions before rebuilding it. - Show me the open case queue for
/path/to/some-appso I can decide how each case should work. - Generate the rebuild specification for
/path/to/some-appafter all cases have been resolved.
How to install Rebuild Dossier
Platform CLI
claude mcp add rebuild-dossier -- npx -y rebuild-dossierPlatform CLI
codex mcp add rebuild-dossier -- npx -y rebuild-dossierConfig file
{
"mcpServers": {
"rebuild-dossier": {
"command": "npx",
"args": [
"-y",
"rebuild-dossier"
]
}
}
}Config file
{
"servers": {
"rebuild-dossier": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rebuild-dossier"
]
}
}
}Platform CLI
gemini mcp add rebuild-dossier npx -y rebuild-dossierStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Rebuild Dossier
How do I install Rebuild Dossier in Claude Code?
Run claude mcp add rebuild-dossier -- npx -y rebuild-dossier. To use crawl_site, install Chromium separately with npx playwright install chromium.
What does Rebuild Dossier do?
It inspects an existing application, collects decisions about ambiguous behavior, and creates a specification, contracts, and tests for another coding-agent session. It does not rebuild the application itself.
Why does Rebuild Dossier use mutation testing?
It deliberately alters the original code to see whether generated tests detect the resulting faults. Tests that fail to catch a mutation are downgraded.
