Repolode
Submit
blader

blader/schematic

A Claude Code and Codex skill that reverse engineers a product and technical spec from a git branch's changes.

View on GitHub
Stars
247
Forks
25
Open issues
2
Last commit
7 months ago

What is it?

Schematic is an agent skill for Claude Code and Codex. Given a git branch, it reads the implementation and writes a structured markdown spec describing what the branch does, covering the problem statement, product requirements, architecture, technical design, file inventory, testing strategy, rollout plan, and risks.

The typical problem it addresses is documentation that is missing or out of date for a feature that already exists in code. Developers can use it to get up to speed on someone else's branch, or to produce PR descriptions and design docs after the work is done.

The skill scopes the branch's diff, splits changed files into groups read by parallel agents, cross-checks the analysis against the full file list to catch omissions, and confirms that every changed file is accounted for in the final spec.

Key features

  • 01Generates an 11-section markdown spec from a branch's implementation.
  • 02Reads changed files with 2-4 parallel agents.
  • 03Cross-checks analysis against the full file list to catch omitted files.
  • 04Installs by cloning into the Claude Code or Codex skills directory.

Use cases

  • Documenting a shipped or in-progress feature branch that lacks a spec.
  • Onboarding onto a colleague's feature branch.
  • Writing PR descriptions or design docs after implementation.

Topics

#ai-agent#claude-code#codex#documentation#git#developer-tools#spec-writing

FAQ

What is schematic?
A Claude Code and Codex skill that reverse engineers a product and technical spec from a git branch's changes. Schematic is an agent skill for Claude Code and Codex. Given a git branch, it reads the implementation and writes a structured markdown spec describing what the branch does, covering the problem statement, product requirements, architecture, technical design, file inventory, testing strategy, rollout plan, and risks.
Is schematic free to use? What license does it have?
schematic is open source under the MIT license. Check the license terms before using it in commercial products.
Is schematic still maintained?
No commits for 6+ months. The last commit to schematic was on Mar 11, 2026.
What can I use schematic for?
Documenting a shipped or in-progress feature branch that lacks a spec. Onboarding onto a colleague's feature branch. Writing PR descriptions or design docs after implementation.
Where can I get schematic?
The source code and installation instructions are on GitHub: https://github.com/blader/schematic

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects