arch-indexlisted
Install: claude install-skill coco-research/coco
# arch-index
Produces one artifact: `.arch/index.json`, a commit-pinned map from each architectural
component of a repository to the real directories and files that implement it. Every
claimed path is verified to exist by a script with an exit code, not by a promise in a
prompt.
**Guiding principle — Paths or it does not exist.** The protocol that consumers follow
is `team:architecture.md`. This file is the producer.
## What this skill is for, and what it is not for
It is for answering, mechanically: which files implement this component, and has that
stopped being true.
It is not a design tool. The index is **reverse-only** — it describes code that exists
on disk at a known commit. There is no mode for specifying a system that has not been
built, because the central check is that every path resolves. Forward design work
belongs in `/team think`, the `SI-*-Design` councils, or
`/util:create-architecture-documentation`.
It is not a codebase-mapping tool either, and it should not act like one. When
`.planning/codebase/` exists, `gsd-map-codebase` has already produced seven structured
documents covering the stack, integrations, architecture, structure, conventions,
testing, and concerns. This skill **reads those and skips crawling entirely.** Crawling
a repository that has already been mapped is the exact waste this skill was designed to
avoid, and duplicating `gsd-map-codebase` would make it a worse version of a tool that
already exists.
It is not a work-allocation mechan