Skip to content

datit309/supergraph / plugins/supergraph/skills/scan

Scan project once per session. Run first β€” all other skills depend on this.

/supergraph:scan

Load verified, project-scoped graph context once. Follow the shared references/codebase-memory-contract.md.

Announce: "πŸ“‘ /supergraph:scan β€” loading project context..."

1. Detect project and branch

Use git branch --show-current, resolve the repository to an absolute path, and run bin/detect-project.sh when present. Otherwise detect commands from:

FileTypeTestLintFormatBuild
package.jsonnodenpm test --npx eslint .npx prettier --write .npm run build
Cargo.tomlrustcargo testcargo clippycargo fmtcargo build
pyproject.tomlpythonpytestruff check .ruff format .python -m build
go.modgogo test ./...golangci-lint rungofmt -w .go build ./...
pubspec.yamlflutterflutter testflutter analyzedart format .flutter build

Ask when none match; never guess commands. Derive one stable CBM_PROJECT from the repository root name and retain it across branches. Default CBM_INDEX_MODE=moderate.

2. Verify provider and freshness

  1. Call list_projects and find CBM_PROJECT.
  2. If found, call index_status(project=CBM_PROJECT).
  3. Treat missing project, changed branch, stale state, tool error, failed state, or status: "degraded" as requiring a new index.
  4. TTL reuse (10m): If index_status returns status: "ready" and BRANCH matches .supergraph-env:BRANCH and now - CBM_INDEXED_AT < 600s and head_sha unchanged, reuse index β€” skip index_repository. Otherwise proceed to step 5. TTL check requires healthy index_status; never cache degraded/stale/error. On cache hit, still re-run index_status once to confirm liveness before get_graph_schema.
  5. Call index_repository(repo_path=<absolute repo path>, name=CBM_PROJECT, mode=CBM_INDEX_MODE) when required (cache miss or stale/degraded). Require status: "indexed".
  6. Re-run index_status; never claim reuse without a healthy response.
  7. Call get_graph_schema(project=CBM_PROJECT) and get_architecture(project=CBM_PROJECT, aspects=["overview","layers","boundaries","clusters","hotspots"]) in parallel after verified index_status.
  8. On cache hit, get_graph_schema and get_architecture may run in parallel immediately after TTL-passed index_status.

On any mandatory provider/index/schema error: STOP, show the exact error and the recovery command (codebase-memory-mcp cli index_repository --repo-path <absolute> --name <project> --mode moderate). Do not write freshness state.

3. Reverify Serena

Always call Serena initial instructions and activate project with the absolute repository path: mcp__serena__activate_project(project=<absolute repo path>). Then load a top-level symbols overview (mcp__serena__get_symbols_overview). Set SERENA_ACTIVE=true only after success; otherwise set it false and report Serena unavailable.

4. Write .supergraph-env

Only after healthy index_status, schema, and architecture responses:

PROJECT_TYPE=...
TEST_CMD=status=0; for test_file in plugins/supergraph/tests/test-*.sh; do bash "$test_file" || status=1; done; exit "$status"
LINT_CMD=bash -n install.sh plugins/supergraph/install.sh plugins/supergraph/tests/test-*.sh
FORMAT_CMD=...
BUILD_CMD=...
BRANCH=...
GRAPH_PROVIDER=codebase-memory-mcp
CBM_PROJECT=...
CBM_INDEX_MODE=moderate
CBM_INDEXED_AT=YYYY-MM-DDTHH:MM:SS
SERENA_ACTIVE=true|false
SCAN_TIMESTAMP=YYYY-MM-DDTHH:MM:SS

Branch-matched TTL reuse still requires index_status and Serena revalidation; TTL only skips index_repository, never skips index_status or schema checks. Serena revalidation is guarded by SERENA_ACTIVE β€” skip initial_instructions if .supergraph-env:SERENA_ACTIVE=true and scan ran <10m ago.

5. Report

Report project/type/commands, provider/project/index status, architecture counts available from the response, Serena status, and whether scan was fresh or reused.

Rules

  • Never record false freshness after errors or degraded state.
  • All graph calls include project=CBM_PROJECT where supported.
  • Respect pagination and failure semantics in the shared contract.
  • For trivial ≀2 files / <20 lines, graph discovery may stop after verified status (no hubs/bridges needed).
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 464kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β€” repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β€” or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 318kUpdated Claude CodeCodexUnverifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 318kUpdated Claude CodeCodexUnverifiedInstall