Files
timmy-home/templates/GENOME-template.md
Alexander Whitestone b8b8bb65fd
Some checks failed
Agent PR Gate / gate (pull_request) Has been cancelled
Agent PR Gate / report (pull_request) Has been cancelled
Self-Healing Smoke / self-healing-smoke (pull_request) Has been cancelled
Smoke Test / smoke (pull_request) Has been cancelled
feat: GENOME.md template + single-repo analyzer (#666)
Template and analyzer for the Codebase Genome batch (issues #667-683).

templates/GENOME-template.md:
  Reusable template with placeholders for repo name, overview,
  architecture, entry points, data flow, abstractions, API surface,
  test coverage, security, and design decisions.

scripts/genome_analyzer.py:
  Auto-generates GENOME.md skeleton from a codebase scan:
  - File counts by extension
  - Directory structure (depth 2)
  - Entry point detection (main.py, scripts/, Makefile, etc.)
  - Test file enumeration
  - README first-paragraph extraction

Usage:
  python3 scripts/genome_analyzer.py /path/to/repo --output GENOME.md
  python3 scripts/genome_analyzer.py /path/to/repo --dry-run
2026-04-16 01:19:41 -04:00

543 B

GENOME.md — {{REPO_NAME}}

Codebase analysis generated {{DATE}}. {{SHORT_DESCRIPTION}}.

Project Overview

{{OVERVIEW}}

Architecture

{{ARCHITECTURE_DIAGRAM}}

Entry Points

{{ENTRY_POINTS}}

Data Flow

{{DATA_FLOW}}

Key Abstractions

{{ABSTRACTIONS}}

API Surface

{{API_SURFACE}}

Test Coverage

Existing Tests

{{EXISTING_TESTS}}

Coverage Gaps

{{COVERAGE_GAPS}}

Critical paths that need tests:

{{CRITICAL_PATHS}}

Security Considerations

{{SECURITY}}

Design Decisions

{{DESIGN_DECISIONS}}