index-project · git:20261118.581e4cd · 2026-11-18 · sha256 a58424497002881c
index-project git:20261118.581e4cdB
Immutable. This exact content never changes and is served at /api/v1/blob/a58424497002881c.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_vseqnzlfsd5345id/a58424497002881c0ae3b8a5ca07999aa233afeb3c9913086c3078fbfa40c003.json
Then /plugin install index-project@markdownregistry-vseqnzlfsd5345id in Claude Code. It installs this exact version, the one graded B here, pinned to the commit it was graded at, and leaves it there.
---
name: index-project
description: Scans and indexes any multi-language repository (Node/TS, Dart/Flutter, Go, Python, Rust, JVM, Swift) into CONTEXT.md with verified stack versions, config/logging seams, verification commands, shared UI primitives/widgets, design tokens, utilities, and module boundaries. Use when starting on an unindexed repo, when CONTEXT.md is still a template, or after structural changes.
---
# Index Project (Multi-Language Codebase Reconnaissance)
Populate `CONTEXT.md` strictly with verified file paths, exported symbols, config/logging seams, and runnable commands so downstream planning and coding never guess or duplicate existing code.
## Decision tree
1. **Does `CONTEXT.md` already have verified, non-template entries matching current manifests?**
- **Yes (and no major refactor occurred)** → Read `CONTEXT.md` and spot-check only the directories touched by the current task.
- **No (template placeholders or stale paths)** → Run the indexing workflow below.
2. **Is the codebase large (>100 source files)?**
- **Yes** → Run the black-box scanner script first, then delegate deep symbol extraction to `codebase-investigator` via `invoke_subagent`, and verify key files with `read_file`.
- **No** → Run the black-box scanner script, then read key manifests/primitives directly.
## Indexing workflow
1. **Run the Black-Box Scanner First**:
- Inspect script options via `--help`, then execute:
```bash
node .agents/skills/index-project/scripts/scan-repo.mjs --help
node .agents/skills/index-project/scripts/scan-repo.mjs
```
2. **Verify Manifests, Config & Logging Seams**:
- Read the detected manifests (`package.json`, `pubspec.yaml`, `go.mod`, `Cargo.toml`, `pyproject.toml`, `tsconfig.json`, `analysis_options.yaml`).
- Locate and read the startup configuration module (`.env` loader, `--dart-define` / config class) and structured logger helper.
3. **Inspect Shared UI / Widgets & Design Tokens (or mark `N/A`)**:
- Read barrel files, shared widget/component folders (`components/`, `widgets/`, `ui/`, `shared/`), and theme/token files (`ThemeData`, `AppColors`, `tailwind.config.*`, `globals.css`).
- Record **exact file paths, exported symbols, and key props/variants**.
4. **Inspect Shared Utilities, API Clients, Schemas & State Holders**:
- Read existing HTTP/API clients, auth/session guards, boundary validators, formatters, and shared hooks/providers/BLoCs.
5. **Write `CONTEXT.md` & Verify Every Path**:
- Populate Sections 1–5 of `CONTEXT.md` using only observed paths/symbols; preserve domain invariants in Sections 6–7.
- Confirm every file path cited in `CONTEXT.md` exists on disk.