cyberneticlibrary

Inventory existing codebase architecture

sdlc-brownfield-inventoryworkflowsetup L30
carlos-sobral/ai-squad
What it does

Find correctness bugs via code-reading agents

Best for

Inventorying legacy repos across standardized dimensions without claiming maturity.

Inputs
  • · workflow args object
  • · batch base path and count
  • · acceptance criteria, diff scope, URLs
  • · repo path and HEAD SHA
Outputs
  • · structured findings per dimension
  • · findings array with severity/mechanism
  • · candidate implementations or solutions
Requires
  • · Claude agent API
  • · parallel execution harness
  • · Workflow phase management
  • · JSON schema validation
  • · git read-only commands
  • · grep/ripgrep
Preconditions

Existing repo with HEAD SHA for cache-stale guard

Failure modes
  • · agent returns malformed/invalid schema
  • · one agent in parallel batch times out or errors
  • · args parsing fails or missing required fields
  • · input file not found or unreadable
  • · agent role/specialist unavailable
Trust signals
  • · stored in repo: carlos-sobral/ai-squad
  • · strict JSON schema validation
  • · concrete examples in spec