repo-genome

repo-genome

Codex skill: 7-section readiness scorecard for a local repo — the ADR-031 Bundle JSON Pattern surfaced through Codex (iter 110 → 114).

What it does

Answers a different question than analyze-repo:

analyze-repo — "which archetype / template / agents fit this repo?"
repo-genome — "is this repo READY for that harness, and what's the risk?"

Produces a 7-section report:

Repo profile — type, languages, build/test commands, ci presence
Agent topology — recommended roles (maintainer / tester / security / release)
MCP risk model — surface + numeric risk + policy posture
Test confidence — how strong are the test signals
Release readiness — buildable / testable / ci-wired
Recommended harness plan — template, archetype, hosts, agents, skills
Scorecard — risk_score, publish_readiness, test_confidence

LOCAL-only, deterministic, never executes repo code. Same invariant as analyze-repo (inherited via the shared inventory/profile pipeline).

Verdict	Exit	Meaning
`ready`	0	publish_readiness >= 0.75 && risk_score < 0.35
`needs-work`	1	somewhere in the middle
`blocked`	2	risk_score >= 0.7

Usage from Codex

/repo-genome path=./my-repo
/repo-genome path=./my-repo bundle=true
/repo-genome path=./my-repo out=./harness-genome.json

Equivalent CLI

harness genome ./my-repo                          # text report
harness genome ./my-repo --json                   # 6-field scorecard JSON
harness genome ./my-repo --bundle                 # ADR-031 schema-1 envelope
harness genome ./my-repo --out harness-genome.json # write scorecard to file

Sample 6-field output (--json)

{
  "repo_type": "rust_node_polyglot_mcp_ci",
  "agent_topology": ["maintainer", "tester", "security", "release"],
  "risk_score": 0.31,
  "mcp_surface": "local_default_deny",
  "test_confidence": 0.86,
  "publish_readiness": 0.78
}

When to use it

Before scaffolding a harness — run genome first, decide whether the repo is ready or needs cleanup
In CI on incoming PRs — post the genome report as a check; alert when risk_score crosses a threshold
For support tickets — --bundle emits the full readiness snapshot sanitised for safe sharing

Related skills

repo-analyze (iter — proposed) — the archetype-and-plan recommendation
compare-harnesses (iter 109) — diff two scaffolded harnesses
diag-harness (iter 70) — kernel-version skew check
score-harness (iter 114) — post-scaffold harness scorecard

About this skill