← ClaudeAtlas

codebase-suitelisted

Structured, phase-based workflow for analyzing, documenting, and preparing unfamiliar codebases. Read-only first, human checkpoints after each phase. Produces durable technical documentation (incl. architecture.md and important-files.md) in _docs/ as well as analysis artifacts in _docs/intake/, and optionally provides the documentation to AI agents via CLAUDE.md/AGENTS.md. Includes a refresh mode that re-verifies existing documentation claim by claim against the current code.
mdeuerlein/ai-loomkit · ★ 0 · AI & Automation · score 73
Install: claude install-skill mdeuerlein/ai-loomkit
# Codebase Suite Gives an agent a solid understanding of an unfamiliar codebase — structured, traceable, without uncontrolled changes — and produces maintainable project documentation from it. ## Goal Instead of diving into a foreign codebase in an unstructured way, this skill runs through a clearly paced process: - Capture the project context - Inventory the technical foundation - Understand features and structure - Assess risks and technical debt - Create documentation - Prepare the repository structure - Plan and prioritize the implementation - Later: re-verify the documentation against the evolved code and update it The result: - **`_docs/`** — durable technical documentation suitable for both humans and agents (`architecture.md`, `important-files.md`, `setup.md`, `database.md`, `deployment.md`, `api.md`, `workflows.md`, `known-issues.md`). Plus **`_docs/TODO.md`** as the central, curated overview of open tasks that points to the detailed sources (e.g. `known-issues.md`, `_docs/intake/`). - **`_docs/intake/`** — versionable analysis and process artifacts (context, inventory, risk, roadmap, implementation plan). These go stale faster than `_docs/`, so they are deliberately kept separate. - **Optional `CLAUDE.md` + `AGENTS.md`** — when the documentation should be provided to AI agents. `AGENTS.md` carries the docs index, `CLAUDE.md` only points to it. - **`_docs/intake/run-log.md`** — one line per suite run (date, mode, commit) so later runs know what state the docume