project
Analyze project structure, metrics, and code health. Manage architectural decisions and sync documentation.
Instructions
Code-intelligence (codegraph-compatible) project-intelligence hub. Covers codegraph_metrics (graph-level stats), project overview, file enumeration, smart task-focused context, parser readiness, agent skills/workflow, decision journal, and doc sync in one tool. Pick a capability via action:
PROJECT INFO (read-only):
action=overview — high-level summary of languages, entry points, and architecture. Best first call on an unfamiliar repo. Params: format.
action=files — enumerate source files with filtering. Params: path, extensions, limit, format.
action=smart — one-shot orientation for a single file: file_health grade, exported symbols (the file's public API), upstream/downstream dependencies, associated test files, and edit-risk in one envelope (replaces Read + file_health + dependency_analysis + safe_to_edit). Params: file_path.
action=parser — check tree-sitter parser readiness for the project languages. Params: format.
action=tools — verify availability of CLI tools (ripgrep, fd, etc.). Params: (none).
action=metrics — codegraph graph-level statistics (node/edge counts, top hubs, codegraph_metrics equivalent). Params: format.
action=skills — enumerate available agent skills for this project. Params: format.
action=workflow — recommended agent workflow for the current task type. Params: task_type, format.
DECISION + DOC (may write):
action=journal — persistent architectural decision journal. Params: mode (record/get/search/supersede), title, rationale, verdict, query, verdict_filter, id, new_id, scope_paths, alternatives, related_symbols, tags, path_scope, limit.
action=doc_sync — sync documentation to current code state. Params: path, dry_run.
For index lifecycle (status/build/full/auto/sync/cache), use the index facade instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Which capability to invoke. One of: doc_sync, files, journal, metrics, overview, parser, skills, smart, tools, workflow | |
| scope | No | Action discriminator (e.g. point|graph). | |
| mode | No | Action sub-mode (e.g. summary|cycles). | |
| file_path | No | Target file path. | |
| symbol | No | Symbol/function name. | |
| function_name | No | Function name (alias of symbol). | |
| query | No | Search query/pattern. | |
| language | No | Language hint (usually auto). | |
| limit | No | Max results. | |
| output_format | No | Output format (toon|json). |