Project Harness Evidence
Inspect repository-owned execution and delivery capability, then return independent finding candidates. The lead owns joins, severity, scores, recommendations, and report copy. The canonical Software Fluency model owns the full L1-L5 ladder; keep all five dimensions below without reproducing that ladder.
Boundary
- Inspect only the target project, scoped history, and lead-supplied
core-change-watch evidence-packenvelope. - Do not inspect Session facts, user Memory, prior reports, scanner conclusions, or another agent's brief. Agent Customize owns configured asset quality.
- Open at most three project owners in quick mode or five in normal mode. Use source and tests to verify history/scanner leads.
- Static declarations prove intent or presence, not runnable behavior, current health, enforcement, delivery, or ownership.
Preserve the Five Evaluation Dimensions
Inspect every applicable dimension. Do not replace this model with churn, testing, or observability alone, and do not silently omit unavailable evidence.
| Dimension | Core question | Original submetrics to preserve |
|---|---|---|
| Context Map | Can an agent reach the right context, boundary, risk, and next step? | Task Entrypoint; Context & Boundary Map; Risk & Next-Step Route |
| Environment Readiness | Can it enter a versioned, bounded, diagnosable environment and run/reset resources without guessing? | Environment Readiness Entry; Run & Doctor Command Surface; State Reset & Isolation |
| Fast Feedback | Do affected checks return timely, actionable behavior evidence? | Validation Signal Layers; Signal Speed & Actionability; Affected Check Routing |
| Quality Gates | Are relevant rules mechanically checked and repairable? | Rule Coverage; Enforcement Gate Strength; Rule Repair Path |
| Change Safety | Are agent changes bounded, accepted through evidence, and recoverable? | Agent Lifecycle Guardrails; Merge Acceptance Path; Side-Effect, Permission & Recovery Boundary |
Calibrate each applicable submetric against the canonical model: absent or unusable evidence; partial/declarative evidence; a runnable baseline; integrated, affected, or enforced behavior; then observed, auditable, adaptive behavior. Preserve Unavailable or Not applicable with a reason. Do not emit a standalone Software Fluency score.
Start With Core Change Risk
Infer the smallest core candidate from the 30/90/180-day history, current diff, and responsibility map. Prioritize frequently changed files and responsibility-heavy or long methods, then inspect:
- the trigger, boundary/decision, failure or recovery, and result path;
- focused tests mapped to that path, including negative and recovery cases;
- whether the path is understandable or concentrates unrelated decisions;
- whether relevant architecture, schema, security, generated-artifact, migration, or acceptance gates constrain changes.
Churn and method length are risk leads, not defects. Use them to choose where to exercise the five dimensions, not as replacement dimensions.
Inspect the AI Debug Route
For the most material core/failure path, read Observability for AI Debugging and inspect one bounded scenario. Determine whether the real route is discoverable, runnable, readable, correlatable, verifiable, and safe and reversible.
Observability is cross-cutting evidence, not a sixth dimension. Map each result to the affected Context Map, Environment Readiness, Fast Feedback, Quality Gates, or Change Safety submetric. Logger imports, dependencies, and log-call counts are only search leads; do not invent a command, port, sink, topology, or production claim.
Inspect the Supporting Loop
Cover the original dimensions around the named risk:
- route from instructions and architecture to the correct owner and check;
- setup, supported runtime, start, reset, isolation, and doctor behavior;
- fast/full test, lint, type, contract, integration, E2E, browser, and runtime smoke layers, including affected-check routing and failure artifacts;
- mechanical architecture, security, schema, migration, generated-drift, and design gates, plus their repair paths;
- lifecycle controls, permissions, side effects, acceptance/merge evidence, rollback, recovery, and escalation.
If a material core path lacks a dependable change-review trigger, assess the packaged scripts/review-trigger/ route as a possible existing owner. Mention it only when its trigger, runtime, inputs, output sink, and verifier fit the project. Its presence alone is not a recommendation or proof of enforcement.
Return
Write a compact Markdown brief in the user's language. Include scope/history boundary, evidence across all five dimensions, strongest capabilities, core risks, test and observability coverage, owner references, missing evidence, and normally three to five potential findings (up to three in quick mode).
Express potential findings naturally; no fixed fields or JSON schema are required. Each must make its consequence, evidence, owner boundary, and uncertainty understandable. Return fewer when evidence is weak and never fill a quota. Do not assign final severity, score, repair, or recommendation. End with the claims the lead must not make from this evidence.