discover

/greppable:discover — Full Codebase Scan

Scan the project structure and generate GDL artifacts that document the codebase.

Arguments

$ARGUMENTS contains optional path or focus area:

• Empty: scan entire codebase
• Path (e.g., src/auth/): focus scan on that directory
• Description (e.g., "authentication layer"): focus scan contextually

Pre-Flight

1. Read config from .claude/greppable.local.md to determine active layers and gdl_root. If no config, use defaults: all layers enabled, gdl_root=docs/gdl.

2. Run bridge detection pre-scanner:

   bash "${CLAUDE_PLUGIN_ROOT}/scripts/gdl-prescan.sh" <target_dir> --json
   

   This detects which bridge tools can generate skeletons automatically (code maps via src2gdlc, schema maps via sql2gdls/prisma2gdls/db2gdls).

3. Report scope and bridge plan:

   Scanning project structure...
   
   Bridge detection found:
     - TypeScript: 142 files → src2gdlc (automatic code maps)
     - Python: 24 files → src2gdlc (automatic code maps)
     - SQL migrations: 3 files → sql2gdls (automatic schema maps)
     - OpenAPI specs: 2 files → openapi2gdla (automatic API contracts)
     - GraphQL schemas: 1 file → graphql2gdla (automatic API contracts)
   
   Discover will:
     1. Run bridge tools for automatic skeleton generation (fast, scripted)
     2. Agent enriches skeletons with descriptions and relationships
     3. Generate architecture diagrams (.gdld) from codebase understanding
     4. Synthesize: concept anchors, overview diagram, and proposed coding rules
   
   This is a token-intensive process. Proceed? [yes / cancel]
   

4. Run bridge tools (scripted, fast): For each bridge detected by prescan, execute the recommended command with actual paths substituted:

   # Example: Code maps
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/src2gdlc.sh" <target_dir> --output=<gdl_root>/code --recursive --lang=typescript
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/src2gdlc.sh" <target_dir> --output=<gdl_root>/code --recursive --lang=python
   # Example: Schema maps (iterate over individual files)
   for f in <migrations_dir>/*.sql; do bash "${CLAUDE_PLUGIN_ROOT}/scripts/sql2gdls.sh" "$f" --output=<gdl_root>/schema; done
   for f in <schema_dir>/*.prisma; do bash "${CLAUDE_PLUGIN_ROOT}/scripts/prisma2gdls.sh" "$f" --output=<gdl_root>/schema; done
   # Example: API contracts
   for f in <api_dir>/*.json <api_dir>/*.yaml; do bash "${CLAUDE_PLUGIN_ROOT}/scripts/openapi2gdla.sh" "$f" --output=<gdl_root>/api; done
   for f in <schema_dir>/*.graphql; do bash "${CLAUDE_PLUGIN_ROOT}/scripts/graphql2gdla.sh" "$f" --output=<gdl_root>/api; done
   

   Track failures: if a bridge fails, log warning and continue with remaining bridges. Report both successful and failed bridges before proceeding.