149 repositories across 2 orgs · 2026-05-11 09:06
Which phase is the weakest for each repo
An AI agent fixing a bug goes through these phases. Scores show ecosystem average per phase.
| Repository | Score | Level | Languages | |
|---|---|---|---|---|
| opendatahub-operator | 90 | Ready | Go, Shell, JavaScript | |
| opendatahub-tests | 90 | Ready | Python | |
| model-metadata-collection | 89 | Ready | Go | |
| notebooks | 87 | Ready | Python, Shell, TypeScript | |
| odh-dashboard | 86 | Ready | TypeScript, Go, JavaScript | |
| eval-hub | 86 | Ready | Go, Shell, Python | |
| kube-auth-proxy | 85 | Ready | Go, Shell, JavaScript | |
| openclaw | 84 | Ready | TypeScript, Kotlin, Shell | |
| model-registry | 83 | Ready | TypeScript, Go, Python | |
| batch-gateway | 83 | Ready | Go, Shell | |
| litellm | 81 | Ready | Python, TypeScript, JavaScript | |
| data-science-pipelines-operator | 81 | Ready | Go, Shell, Python | |
| odh-ide-extensions | 81 | Ready | Python, TypeScript, JavaScript | |
| mlflow-operator | 80 | Ready | Python, Go, Shell | |
| model-registry-operator | 80 | Ready | Go, Shell | |
| odh-cli | 80 | Ready | Go | |
| ogx | 80 | Ready | Python, TypeScript, Shell | |
| feast | 80 | Ready | Python, TypeScript, Go | |
| spark-operator | 79 | Partially Ready | Go, Shell, Python | |
| llm-d-inference-scheduler | 78 | Partially Ready | Go, Shell | |
| llama-stack-provider-trustyai-garak | 78 | Partially Ready | Python | |
| workload-variant-autoscaler | 78 | Partially Ready | Go, Shell, Python | |
| pipelines-components | 77 | Partially Ready | Python, Shell | |
| kserve-autogluon-server | 76 | Partially Ready | Python, Go, Shell | |
| mlflow | 76 | Partially Ready | Python, TypeScript, JavaScript | |
| modelmesh-serving | 75 | Partially Ready | Go, Shell, Python | |
| NeMo-Guardrails | 74 | Partially Ready | Python, JavaScript, Shell | |
| kuberay | 74 | Partially Ready | Go, Python, TypeScript | |
| argo-workflows | 74 | Partially Ready | Go, Python, TypeScript | |
| data-science-pipelines | 72 | Partially Ready | Python, TypeScript, Go | |
| kubeflow | 71 | Partially Ready | Go, Shell | |
| odh-platform-utilities | 71 | Partially Ready | Go | |
| base-containers | 70 | Partially Ready | Python, Shell | |
| kubeflow-sdk | 70 | Partially Ready | Python | |
| semantic-router | 70 | Partially Ready | Go, TypeScript, Python | |
| ogx-k8s-operator | 70 | Partially Ready | Go, Shell | |
| training-operator | 69 | Partially Ready | Go, Python, Shell | |
| kserve | 69 | Partially Ready | Python, Go, Shell | |
| rhoai-mcp | 69 | Partially Ready | Python | |
| mod-arch-library | 68 | Partially Ready | TypeScript, Go, JavaScript | |
| model-registry-bf4-kf | 68 | Partially Ready | Go, Python, Shell | |
| odh-model-controller | 67 | Partially Ready | Go, Shell | |
| trainer | 67 | Partially Ready | Python, Go, Rust | |
| trustyai-service-operator | 67 | Partially Ready | Go, Shell | |
| trainer-sdk | 67 | Partially Ready | Python, Go, Shell | |
| rhaii-cluster-validation | 66 | Partially Ready | Go | |
| kagenti-operator | 66 | Partially Ready | Go, Shell | |
| models-as-a-service | 66 | Partially Ready | Go, Shell, Python | |
| llm-d-kv-cache | 65 | Partially Ready | Go, Python, C++ | |
| modelmesh-runtime-adapter | 64 | Partially Ready | Go, Shell | |
| openrag | 64 | Partially Ready | TypeScript, Python | |
| langfuse | 64 | Partially Ready | TypeScript, Shell, JavaScript | |
| codeflare-operator | 63 | Partially Ready | Go, Shell | |
| codeflare-operator-poc | 63 | Partially Ready | Go, Shell | |
| training-notebooks | 63 | Partially Ready | Python, Shell, TypeScript | |
| kube-authkit | 62 | Partially Ready | Python | |
| rhoai-observability-mcp | 62 | Partially Ready | Python | |
| MLServer | 62 | Partially Ready | Python, Shell, JavaScript | |
| caikit-nlp | 62 | Partially Ready | Python, Shell | |
| ai-gateway-payload-processing | 60 | Partially Ready | Go, Shell | |
| kube-rbac-proxy | 60 | Partially Ready | Go, Shell | |
| opencode | 60 | Partially Ready | TypeScript, Rust, JavaScript | |
| trustyai-explainability | 60 | Partially Ready | Java, Python | |
| operator-chaos | 60 | Partially Ready | Go, TypeScript | |
| ai-helpers | 60 | Partially Ready | Python, Shell | |
| mcp-server-operator | 59 | Needs Work | Go | |
| elyra | 58 | Needs Work | Python, TypeScript, JavaScript | |
| kueue (verify gate applied) | 58 | Needs Work | Go, JavaScript, Shell | |
| rest-proxy | 57 | Needs Work | Go | |
| odh-test-gen | 55 | Needs Work | Python | |
| elyra-pipeline-editor | 55 | Needs Work | TypeScript, JavaScript | |
| mlflow-go | 55 | Needs Work | Go | |
| caikit-nlp-client | 55 | Needs Work | Python | |
| distributed-workloads (verify gate applied) | 53 | Needs Work | Go, Python, Shell | |
| vllm-tgis-adapter | 53 | Needs Work | Python | |
| llm-d-batch-gateway-operator | 52 | Needs Work | Go | |
| agent-eval-harness | 51 | Needs Work | Python | |
| llama-stack-provider-ragas | 50 | Needs Work | Python | |
| lm-evaluation-harness | 49 | Needs Work | Python, Shell | |
| modelmesh | 49 | Needs Work | Java, Shell | |
| openvino.genai | 48 | Needs Work | C++, Python, TypeScript | |
| autogluon (verify gate applied) | 48 | Needs Work | Python, Shell | |
| guardrails-detectors | 48 | Needs Work | Python | |
| fms-guardrails-orchestrator (verify gate applied) | 46 | Needs Work | Rust, Shell | |
| openvino (verify gate applied) | 46 | Needs Work | C++, Python, JavaScript | |
| llama-stack-client-python (verify gate applied) | 45 | Needs Work | Python | |
| data-processing | 42 | Needs Work | Python | |
| ogx-distribution | 40 | Needs Work | Shell | |
| odh-observability | 40 | Needs Work | Go | |
| vllm-gaudi (verify gate applied) | 39 | Not Ready | Python, Shell, C++ | |
| openvino_model_server (verify gate applied) | 38 | Not Ready | C++, Python, Shell | |
| gpt-researcher (verify gate applied) | 38 | Not Ready | Python, TypeScript, JavaScript | |
| perf_analyzer | 37 | Not Ready | Python | |
| elyra-examples (verify gate applied) | 37 | Not Ready | Python | |
| llama-stack-provider-kfp-trainer (verify gate applied) | 34 | Not Ready | Python, Shell | |
| openvino_contrib (verify gate applied) | 34 | Not Ready | C++, TypeScript, Python | |
| architecture-context (verify gate applied) | 33 | Not Ready | Python, Go | |
| modelcar-base-image (verify gate applied) | 32 | Not Ready | Python, Shell | |
| openvino_tokenizers (verify gate applied) | 29 | Not Ready | C++, Python, JavaScript | |
| rag (verify gate applied) | 28 | Not Ready | Python, Go, Shell | |
| agentic-ci (verify gate applied) | 27 | Not Ready | Python | |
| client (verify gate applied) | 24 | Not Ready | Python, Java | |
| caikit-tgis-serving (verify gate applied) | 23 | Not Ready | Shell | |
| fips-compliance-checker-claude-code-plugin (verify gate applied) | 23 | Not Ready | Python, Shell | |
| odh-s2i-project-cds (verify gate applied) | 18 | Not Ready | Python | |
| ml-metadata (verify gate applied) | 17 | Not Ready | Python, Go, Shell | |
| vllm-orchestrator-gateway (verify gate applied) | 17 | Not Ready | Rust | |
| autofix-skills (verify gate applied) | 16 | Not Ready | Python, Shell | |
| llama-stack-provider-kft (verify gate applied) | 16 | Not Ready | Python | |
| llama-stack-provider-instructlab-train (verify gate applied) | 14 | Not Ready | Python | |
| odh-s2i-project-cookiecutter (verify gate applied) | 13 | Not Ready | Python | |
| agents (verify gate applied) | 13 | Not Ready | Python, Go, Shell | |
| odh-gitops (verify gate applied) | 10 | Not Ready | Shell | |
| skills-registry (verify gate applied) | 10 | Not Ready | Python | |
| opendatahub.io (verify gate applied) | 9 | Not Ready | TypeScript | |
| odh-konflux-central (verify gate applied) | 7 | Not Ready | Shell | |
| model-runtimes-agent (verify gate applied) | 6 | Not Ready | Python | |
| knowledge-skills (verify gate applied) | 5 | Not Ready | Unknown | |
| llm-d-playbooks (verify gate applied) | 5 | Not Ready | Shell, Python | |
| odh-s2i-project-simple (verify gate applied) | 4 | Not Ready | Python | |
| aiops-infra (verify gate applied) | 4 | Not Ready | Shell, Python | |
| dsp-dev-tools (verify gate applied) | 4 | Not Ready | Python, Shell |
Actions that would raise the most scores across the ecosystem, sorted by estimated impact.
| Action | Repos Below 40 | Weight | How to Fix |
|---|---|---|---|
| Bug Report Template Quality | 78 repos | 8% | Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Test-to-Source Ratio | 50 repos | 15% | Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| AI Context Files | 72 repos | 8% | Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Architecture Documentation | 50 repos | 3% | Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Coverage Configuration | 65 repos | 3% | Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| PR Template | 68 repos | 2% | Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
The overall score is a weighted average of 20 checks, each scored 0-100. Checks are grouped into 4 phases of an AI bug-fixing workflow:
| Phase | Weight | What it measures |
|---|---|---|
| Understand | 24% | AI Context Files (8%), Bug Report Template Quality (8%), Structured Logging / Errors (3%), Architecture Documentation (3%), Test Fixtures / Sample Data (2%) |
| Navigate | 17% | Code Navigability (5%), Generated Code Ratio (2%), Build / Dependency Setup (5%), Type Safety / Static Analysis (3%), Dependency Complexity (2%) |
| Verify | 46% | Test-to-Source Ratio (15%), One-Command Test Execution (11%), Coverage Configuration (3%), CI Runs Tests on PRs (10%), Test Isolation (unit vs e2e) (4%), Pre-commit / Local Hooks (3%) |
| Submit | 13% | Code Ownership (CODEOWNERS) (1%), PR Template (2%), Linting / Formatting in CI (5%), Contributing / Dev Guide (5%) |
Verify Phase Gate: If a repo's average Verify score is below 50, the overall score receives a smooth penalty multiplier that scales linearly from x0.4 (verify avg = 0) to x1.0 (verify avg = 50). This reflects that without test infrastructure, autonomous bug fixing is not viable.
Readiness levels: Ready (80+), Partially Ready (60-79), Needs Work (40-59), Not Ready (<40).
| Check | Avg Score | Weight | |
|---|---|---|---|
| Bug Report Template Quality | 34 | 8% | |
| Architecture Documentation | 35 | 3% | |
| AI Context Files | 36 | 8% | |
| PR Template | 37 | 2% | |
| Coverage Configuration | 38 | 3% | |
| Test-to-Source Ratio | 47 | 15% | |
| Build / Dependency Setup | 50 | 5% | |
| Test Fixtures / Sample Data | 50 | 2% | |
| Pre-commit / Local Hooks | 51 | 3% | |
| Code Ownership (CODEOWNERS) | 52 | 1% | |
| One-Command Test Execution | 61 | 11% | |
| Contributing / Dev Guide | 62 | 5% | |
| Structured Logging / Errors | 64 | 3% | |
| Linting / Formatting in CI | 64 | 5% | |
| Type Safety / Static Analysis | 67 | 3% | |
| Code Navigability | 74 | 5% | |
| Dependency Complexity | 75 | 2% | |
| Test Isolation (unit vs e2e) | 76 | 4% | |
| CI Runs Tests on PRs | 77 | 10% | |
| Generated Code Ratio | 95 | 2% |
Green (80+) = ready, Yellow (40-79) = partial, Red (<40) = gap.
| Repository | Score | AI Context Files | Bug Report Template Quality | Structured Logging / Errors | Architecture Documentation | Test Fixtures / Sample Data | Code Navigability | Generated Code Ratio | Build / Dependency Setup | Type Safety / Static Analysis | Dependency Complexity | Code Ownership (CODEOWNERS) | Test-to-Source Ratio | One-Command Test Execution | Coverage Configuration | CI Runs Tests on PRs | PR Template | Linting / Formatting in CI | Contributing / Dev Guide | Test Isolation (unit vs e2e) | Pre-commit / Local Hooks |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| opendatahub-operator | 90 | 100 | 100 | 100 | 100 | 60 | 70 | 100 | 80 | 80 | 90 | 100 | 70 | 100 | 100 | 100 | 100 | 80 | 100 | 85 | 100 |
| opendatahub-tests | 90 | 92 | 100 | 90 | 40 | 80 | 70 | 100 | 90 | 80 | 90 | 100 | N/A | 80 | N/A | 100 | 100 | 100 | 100 | N/A | 100 |
| model-metadata-collection | 89 | 92 | 100 | 100 | 80 | 80 | 70 | 100 | 90 | 80 | 70 | 100 | 85 | 90 | 80 | 100 | 85 | 80 | 100 | 90 | 90 |
| notebooks | 87 | 100 | 100 | 90 | 100 | 90 | 70 | 100 | 90 | 80 | 90 | 100 | 38 | 100 | 100 | 100 | 100 | 100 | 100 | 100 | 100 |
| odh-dashboard | 86 | 100 | 100 | 20 | 100 | 60 | 90 | 100 | 90 | 80 | 90 | 100 | 70 | 80 | 80 | 100 | 100 | 100 | 90 | 90 | 70 |
| eval-hub | 86 | 100 | 90 | 100 | 80 | 60 | 70 | 100 | 90 | 80 | 70 | 100 | 85 | 80 | 100 | 70 | 85 | 80 | 100 | 90 | 100 |
| kube-auth-proxy | 85 | 92 | 100 | 90 | 70 | 80 | 90 | 100 | 100 | 80 | 90 | 100 | 85 | 100 | 80 | 30 | 85 | 80 | 100 | 90 | 100 |
| openclaw | 84 | 100 | 100 | 20 | 40 | 90 | 70 | 100 | 70 | 90 | 90 | 100 | 100 | 60 | 60 | 100 | 100 | 80 | 80 | 90 | 100 |
| model-registry | 83 | 100 | 100 | 90 | 40 | 70 | 70 | 80 | 90 | 80 | 90 | 100 | 38 | 100 | 100 | 100 | 100 | 80 | 100 | 90 | 90 |
| batch-gateway | 83 | 68 | 100 | 100 | 40 | 90 | 70 | 100 | 80 | 80 | 90 | 60 | 70 | 100 | 80 | 100 | 85 | 80 | 60 | 90 | 100 |
| litellm | 81 | 100 | 65 | 70 | 40 | 60 | 70 | 100 | 80 | 80 | 90 | 0 | 64 | 100 | 0 | 100 | 100 | 100 | 100 | 100 | 100 |
| data-science-pipelines-operator | 81 | 100 | 100 | 100 | 30 | 90 | 70 | 100 | 90 | 80 | 50 | 100 | 64 | 100 | 80 | 100 | 85 | 80 | 0 | 85 | 90 |
| odh-ide-extensions | 81 | 92 | 100 | 70 | 55 | 80 | 90 | 100 | 60 | 90 | 90 | 100 | 64 | 80 | 80 | 100 | 85 | 40 | 100 | 90 | 70 |
| mlflow-operator | 80 | 80 | 100 | 100 | 70 | 80 | 70 | 100 | 90 | 80 | 50 | 100 | 75 | 90 | 80 | 100 | 85 | 80 | 40 | 90 | 0 |
| model-registry-operator | 80 | 100 | 85 | 100 | 70 | 90 | 70 | 80 | 90 | 80 | 30 | 100 | 50 | 80 | 80 | 100 | 85 | 80 | 100 | 70 | 90 |
| odh-cli | 80 | 100 | 0 | 90 | 70 | 60 | 90 | 100 | 90 | 80 | 90 | 100 | 70 | 90 | 80 | 100 | 100 | 80 | 90 | 90 | 100 |
| ogx | 80 | 100 | 100 | 90 | 80 | 60 | 70 | 100 | 60 | 80 | 90 | 60 | 50 | 60 | 80 | 100 | 70 | 100 | 100 | 90 | 100 |
| feast | 80 | 100 | 90 | 90 | 70 | 90 | 70 | 100 | 80 | 80 | 90 | 100 | 35 | 100 | 80 | 100 | 85 | 80 | 50 | 90 | 90 |
| spark-operator | 79 | 80 | 100 | 100 | 40 | 90 | 70 | 60 | 70 | 80 | 50 | 60 | 70 | 90 | 100 | 100 | 100 | 80 | 50 | 70 | 70 |
| llm-d-inference-scheduler | 78 | 0 | 70 | 100 | 80 | 70 | 70 | 100 | 80 | 80 | 90 | 100 | 85 | 100 | 100 | 100 | 70 | 80 | 100 | 90 | 0 |
| llama-stack-provider-trustyai-garak | 78 | 100 | 100 | 100 | 70 | 60 | 30 | 100 | 30 | 80 | 10 | 60 | 50 | 90 | 80 | 100 | 85 | 80 | 100 | 90 | 100 |
| workload-variant-autoscaler | 78 | 100 | 0 | 90 | 40 | 90 | 70 | 100 | 90 | 80 | 90 | 100 | 85 | 80 | 80 | 100 | 0 | 80 | 100 | 90 | 70 |
| pipelines-components | 77 | 68 | 100 | 20 | 40 | 60 | 90 | 100 | 70 | 50 | 90 | 100 | 43 | 80 | 100 | 100 | 85 | 100 | 100 | 90 | 100 |
| kserve-autogluon-server | 76 | 100 | 80 | 90 | 40 | 70 | 30 | 80 | 70 | 80 | 90 | 100 | 43 | 100 | 80 | 100 | 100 | 80 | 50 | 90 | 90 |
| mlflow | 76 | 80 | 100 | 70 | 80 | 90 | 50 | 100 | 60 | 80 | 90 | 100 | 53 | 60 | 0 | 100 | 85 | 100 | 100 | 90 | 100 |
| modelmesh-serving | 75 | 0 | 100 | 100 | 40 | 90 | 90 | 80 | 90 | 80 | 70 | 100 | 50 | 100 | 80 | 100 | 85 | 100 | 50 | 70 | 90 |
| NeMo-Guardrails | 74 | 44 | 100 | 90 | 40 | 90 | 70 | 100 | 80 | 70 | 90 | 0 | 64 | 80 | 80 | 70 | 0 | 80 | 100 | 90 | 100 |
| kuberay | 74 | 0 | 95 | 90 | 40 | 0 | 70 | 60 | 60 | 80 | 90 | 60 | 85 | 100 | 0 | 100 | 100 | 100 | 70 | 70 | 100 |
| argo-workflows | 74 | 0 | 90 | 90 | 80 | 90 | 90 | 80 | 100 | 80 | 90 | 60 | 50 | 100 | 80 | 100 | 85 | 80 | 70 | 90 | 0 |
| data-science-pipelines | 72 | 100 | 15 | 90 | 40 | 90 | 70 | 80 | 60 | 80 | 90 | 100 | 53 | 80 | 0 | 100 | 85 | 100 | 70 | 90 | 100 |
| kubeflow | 71 | 100 | 15 | 100 | 80 | 0 | 70 | 100 | 0 | 80 | 80 | 100 | 70 | 100 | 80 | 100 | 0 | 80 | 50 | 70 | 90 |
| odh-platform-utilities | 71 | 92 | 0 | 90 | 15 | 60 | 90 | 100 | 60 | 80 | 50 | 0 | 70 | 80 | 100 | 100 | 0 | 80 | 70 | 90 | 100 |
| base-containers | 70 | 100 | 100 | 20 | 0 | 40 | 70 | 100 | 0 | 80 | 80 | 0 | 85 | 60 | 0 | 100 | 85 | 80 | 100 | 90 | 0 |
| kubeflow-sdk | 70 | 100 | 55 | 20 | 40 | 80 | 30 | 100 | 60 | 50 | 90 | 100 | 38 | 80 | 100 | 100 | 100 | 80 | 80 | 90 | 90 |
| semantic-router | 70 | 80 | 15 | 70 | 40 | 70 | 70 | 100 | 0 | 80 | 80 | 60 | 50 | 100 | 60 | 100 | 55 | 100 | 100 | 90 | 90 |
| ogx-k8s-operator | 70 | 0 | 15 | 100 | 0 | 80 | 70 | 100 | 90 | 80 | 50 | 60 | 85 | 90 | 100 | 100 | 0 | 100 | 100 | 50 | 70 |
| training-operator | 69 | 0 | 55 | 90 | 40 | 90 | 90 | 60 | 80 | 80 | 90 | 100 | 38 | 80 | 80 | 100 | 70 | 100 | 90 | 90 | 100 |
| kserve | 69 | 0 | 80 | 90 | 40 | 70 | 30 | 80 | 70 | 80 | 90 | 100 | 43 | 100 | 100 | 100 | 100 | 80 | 60 | 90 | 90 |
| rhoai-mcp | 69 | 100 | 0 | 20 | 40 | 60 | 70 | 100 | 90 | 80 | 90 | 0 | 53 | 100 | 80 | 100 | 0 | 80 | 100 | 90 | 0 |
| mod-arch-library | 68 | 100 | 0 | 70 | 80 | 40 | 90 | 100 | 60 | 80 | 80 | 100 | 53 | 80 | 60 | 100 | 100 | 0 | 90 | 90 | 70 |
| model-registry-bf4-kf | 68 | 0 | 85 | 70 | 15 | 60 | 70 | 20 | 90 | 80 | 50 | 100 | 38 | 80 | 100 | 100 | 85 | 80 | 100 | 90 | 90 |
| odh-model-controller | 67 | 0 | 0 | 100 | 30 | 80 | 90 | 100 | 100 | 80 | 50 | 100 | 70 | 90 | 80 | 100 | 85 | 80 | 40 | 70 | 90 |
| trainer | 67 | 0 | 55 | 90 | 40 | 90 | 90 | 80 | 60 | 80 | 90 | 100 | 13 | 100 | 80 | 100 | 70 | 100 | 90 | 100 | 90 |
| trustyai-service-operator | 67 | 100 | 0 | 100 | 30 | 60 | 70 | 100 | 90 | 80 | 70 | 0 | 50 | 90 | 80 | 100 | 0 | 80 | 70 | 70 | 0 |
| trainer-sdk | 67 | 0 | 55 | 90 | 40 | 60 | 90 | 80 | 60 | 80 | 90 | 100 | 13 | 100 | 80 | 100 | 70 | 100 | 100 | 90 | 90 |
| rhaii-cluster-validation | 66 | 100 | 0 | 90 | 15 | 60 | 70 | 100 | 80 | 80 | 50 | 0 | 85 | 80 | 0 | 100 | 0 | 80 | 40 | 90 | 0 |
| kagenti-operator | 66 | 68 | 0 | 100 | 15 | 0 | 70 | 100 | 0 | 80 | 80 | 100 | 85 | 100 | 0 | 100 | 0 | 100 | 50 | 90 | 70 |
| models-as-a-service | 66 | 100 | 0 | 100 | 40 | 40 | 50 | 100 | 0 | 80 | 80 | 100 | 53 | 90 | 60 | 100 | 0 | 100 | 100 | 90 | 0 |
| llm-d-kv-cache | 65 | 0 | 0 | 100 | 80 | 90 | 90 | 100 | 90 | 80 | 70 | 100 | 53 | 100 | 0 | 100 | 0 | 80 | 50 | 90 | 100 |
| modelmesh-runtime-adapter | 64 | 0 | 0 | 100 | 40 | 0 | 90 | 60 | 90 | 80 | 50 | 100 | 70 | 100 | 0 | 100 | 40 | 80 | 50 | 90 | 90 |
| openrag | 64 | 0 | 100 | 90 | 40 | 60 | 70 | 100 | 90 | 50 | 90 | 0 | 25 | 100 | 0 | 100 | 0 | 40 | 100 | 90 | 70 |
| langfuse | 64 | 100 | 80 | 70 | 40 | 0 | 70 | 100 | 70 | 0 | 80 | 30 | 50 | 0 | 0 | 100 | 100 | 100 | 100 | 90 | 70 |
| codeflare-operator | 63 | 0 | 0 | 90 | 0 | 50 | 70 | 100 | 90 | 80 | 10 | 100 | 64 | 90 | 80 | 100 | 0 | 100 | 100 | 30 | 90 |
| codeflare-operator-poc | 63 | 0 | 0 | 90 | 0 | 50 | 70 | 100 | 90 | 80 | 10 | 100 | 64 | 90 | 80 | 100 | 0 | 100 | 100 | 30 | 90 |
| training-notebooks | 63 | 0 | 80 | 100 | 40 | 60 | 70 | 100 | 60 | 80 | 90 | 100 | 25 | 70 | 0 | 100 | 0 | 100 | 90 | 90 | 100 |
| kube-authkit | 62 | 0 | 0 | 70 | 15 | 60 | 70 | 100 | 60 | 70 | 90 | 0 | 100 | 60 | 80 | 100 | 0 | 80 | 90 | 90 | 0 |
| rhoai-observability-mcp | 62 | 0 | 0 | 50 | 15 | 40 | 90 | 100 | 90 | 80 | 90 | 0 | 85 | 60 | 80 | 100 | 0 | 80 | 90 | 90 | 0 |
| MLServer | 62 | 0 | 0 | 70 | 40 | 90 | 90 | 100 | 90 | 80 | 80 | 100 | 64 | 80 | 0 | 100 | 0 | 80 | 90 | 90 | 0 |
| caikit-nlp | 62 | 0 | 100 | 70 | 15 | 90 | 70 | 100 | 10 | 50 | 90 | 60 | 53 | 60 | 0 | 100 | 0 | 80 | 90 | 90 | 90 |
| ai-gateway-payload-processing | 60 | 0 | 0 | 100 | 40 | 40 | 70 | 100 | 70 | 80 | 30 | 100 | 85 | 100 | 80 | 100 | 0 | 40 | 0 | 90 | 0 |
| kube-rbac-proxy | 60 | 0 | 0 | 90 | 40 | 90 | 90 | 100 | 90 | 80 | 30 | 100 | 75 | 100 | 0 | 100 | 0 | 80 | 0 | 70 | 0 |
| opencode | 60 | 56 | 80 | 20 | 40 | 60 | 70 | 100 | 10 | 80 | 90 | 100 | 70 | 80 | 0 | 30 | 85 | 0 | 100 | 90 | 70 |
| trustyai-explainability | 60 | 0 | 100 | 0 | 40 | 0 | 90 | 100 | 10 | 80 | 80 | 60 | 70 | 80 | 0 | 100 | 55 | 0 | 100 | 90 | 0 |
| operator-chaos | 60 | 0 | 0 | 90 | 0 | 80 | 70 | 100 | 90 | 80 | 90 | 0 | 85 | 80 | 0 | 100 | 0 | 80 | 40 | 90 | 0 |
| ai-helpers | 60 | 100 | 15 | 20 | 40 | 40 | 70 | 100 | 30 | 70 | 80 | 0 | 10 | 80 | 0 | 100 | 100 | 80 | 100 | 90 | 70 |
| mcp-server-operator | 59 | 0 | 0 | 100 | 0 | 60 | 70 | 80 | 100 | 80 | 10 | 0 | 70 | 90 | 80 | 100 | 0 | 80 | 40 | 90 | 0 |
| elyra | 58 | 0 | 15 | 70 | 40 | 60 | 70 | 100 | 60 | 60 | 90 | 0 | 38 | 90 | 80 | 100 | 0 | 80 | 50 | 90 | 70 |
| kueue | 58 | 0 | 15 | 90 | 40 | 90 | 70 | 80 | 90 | 80 | 90 | 100 | 85 | 80 | 0 | 60 | 85 | 40 | 50 | 70 | 0 |
| rest-proxy | 57 | 0 | 0 | 100 | 0 | 0 | 90 | 60 | 90 | 80 | 30 | 100 | 38 | 80 | 80 | 100 | 0 | 80 | 50 | 90 | 90 |
| odh-test-gen | 55 | 0 | 0 | 20 | 30 | 40 | 90 | 100 | 60 | 70 | 90 | 0 | 100 | 60 | 80 | 100 | 0 | 0 | 40 | 90 | 0 |
| elyra-pipeline-editor | 55 | 0 | 0 | 20 | 15 | 90 | 70 | 100 | 80 | 0 | 80 | 0 | 70 | 80 | 60 | 100 | 0 | 40 | 50 | 90 | 70 |
| mlflow-go | 55 | 0 | 0 | 100 | 45 | 60 | 50 | 60 | 60 | 80 | 80 | 0 | 70 | 80 | 0 | 100 | 0 | 80 | 40 | 90 | 0 |
| caikit-nlp-client | 55 | 0 | 0 | 70 | 30 | 90 | 70 | 100 | 0 | 50 | 90 | 0 | 64 | 60 | 80 | 100 | 0 | 80 | 40 | 90 | 100 |
| distributed-workloads | 53 | 100 | 0 | 90 | 40 | 90 | 90 | 100 | 60 | 80 | 70 | 100 | 75 | 0 | 0 | 70 | 0 | 80 | 0 | 50 | 90 |
| vllm-tgis-adapter | 53 | 0 | 0 | 70 | 15 | 80 | 90 | 100 | 0 | 80 | 90 | 100 | 38 | 60 | 80 | 100 | 0 | 80 | 40 | 90 | 90 |
| llm-d-batch-gateway-operator | 52 | 0 | 0 | 100 | 0 | 60 | 70 | 80 | 90 | 80 | 10 | 0 | 85 | 80 | 0 | 100 | 0 | 0 | 40 | 50 | 0 |
| agent-eval-harness | 51 | 100 | 0 | 20 | 15 | 40 | 70 | 100 | 20 | 50 | 90 | 0 | 50 | 90 | 0 | 100 | 0 | 0 | 0 | 90 | 0 |
| llama-stack-provider-ragas | 50 | 0 | 0 | 100 | 15 | 60 | 90 | 100 | 70 | 80 | 50 | 0 | 38 | 60 | 60 | 30 | 0 | 80 | 90 | 90 | 100 |
| lm-evaluation-harness | 49 | 0 | 0 | 70 | 40 | 90 | 90 | 100 | 0 | 50 | 90 | 60 | 10 | 60 | 0 | 100 | 0 | 80 | 100 | 90 | 100 |
| modelmesh | 49 | 0 | 0 | 70 | 40 | 90 | 50 | 100 | 10 | 80 | 80 | 100 | 64 | 70 | 0 | 30 | 40 | 80 | 50 | 90 | 90 |
| openvino.genai | 48 | 0 | 0 | 70 | 40 | 90 | 70 | 100 | 0 | 80 | 90 | 100 | 38 | 0 | 0 | 100 | 100 | 100 | 70 | 90 | 90 |
| autogluon | 48 | 100 | 100 | 70 | 40 | 90 | 70 | 100 | 0 | 50 | 80 | 0 | 38 | 0 | 0 | 30 | 40 | 80 | 80 | 90 | 90 |
| guardrails-detectors | 48 | 0 | 0 | 70 | 30 | 60 | 70 | 100 | 0 | 50 | 80 | 0 | 85 | 60 | 0 | 100 | 0 | 0 | 40 | 90 | 0 |
| fms-guardrails-orchestrator | 46 | 0 | 100 | 0 | 15 | 60 | 30 | 100 | 60 | 80 | 80 | 60 | 25 | 0 | 0 | 100 | 0 | 80 | 70 | 90 | 70 |
| openvino | 46 | 0 | 15 | 70 | 40 | 90 | 70 | 100 | 0 | 80 | 80 | 100 | 43 | 0 | 60 | 100 | 40 | 80 | 70 | 90 | 0 |
| llama-stack-client-python | 45 | 0 | 0 | 20 | 15 | 60 | 90 | 100 | 70 | 80 | 90 | 60 | 19 | 60 | 0 | 30 | 0 | 80 | 100 | 90 | 100 |
| data-processing | 42 | 0 | 0 | 70 | 40 | 0 | 70 | 100 | 0 | 0 | 80 | 60 | 25 | 60 | 0 | 100 | 0 | 80 | 0 | 90 | 90 |
| ogx-distribution | 40 | 0 | 0 | 20 | 30 | 0 | 70 | 100 | 0 | 0 | 80 | 100 | 43 | 0 | 0 | 100 | 70 | 100 | 40 | 70 | 90 |
| odh-observability | 40 | 0 | 0 | 100 | 0 | 0 | 70 | 100 | 90 | 80 | 10 | 0 | 50 | 80 | 80 | 0 | 0 | 40 | 0 | 90 | 0 |
| vllm-gaudi | 39 | 0 | 15 | 70 | 40 | 90 | 70 | 100 | 10 | 80 | 80 | 60 | 53 | 60 | 0 | 30 | 40 | 80 | 50 | 90 | 0 |
| openvino_model_server | 38 | 0 | 15 | 70 | 40 | 50 | 70 | 100 | 60 | 80 | 80 | 100 | 35 | 0 | 50 | 70 | 85 | 0 | 100 | 90 | 0 |
| gpt-researcher | 38 | 80 | 100 | 90 | 40 | 40 | 90 | 100 | 10 | 70 | 90 | 0 | 13 | 60 | 0 | 30 | 0 | 0 | 70 | 90 | 0 |
| perf_analyzer | 37 | 0 | 0 | 20 | 15 | 40 | 90 | 100 | 10 | 50 | 80 | 0 | 19 | 0 | 0 | 100 | 0 | 80 | 40 | 90 | 100 |
| elyra-examples | 37 | 0 | 0 | 100 | 40 | 40 | 90 | 100 | 0 | 0 | 80 | 0 | 19 | 100 | 0 | 30 | 85 | 80 | 50 | 90 | 0 |
| llama-stack-provider-kfp-trainer | 34 | 0 | 0 | 20 | 0 | 0 | 90 | 100 | 10 | 80 | 70 | 0 | 25 | 60 | 0 | 100 | 0 | 0 | 0 | 90 | 0 |
| openvino_contrib | 34 | 0 | 15 | 70 | 40 | 0 | 90 | 100 | 0 | 80 | 80 | 100 | 25 | 0 | 0 | 100 | 0 | 80 | 60 | 90 | 0 |
| architecture-context | 33 | 0 | 0 | 20 | 40 | 0 | 70 | 100 | 80 | 80 | 90 | 0 | 10 | 90 | 0 | 30 | 0 | 80 | 40 | 90 | 0 |
| modelcar-base-image | 32 | 0 | 0 | 70 | 15 | 0 | 90 | 100 | 70 | 50 | 80 | 0 | 38 | 80 | 0 | 30 | 0 | 0 | 0 | 90 | 0 |
| openvino_tokenizers | 29 | 0 | 15 | 70 | 15 | 40 | 70 | 100 | 60 | 80 | 90 | 0 | 19 | 0 | 0 | 100 | 0 | 0 | 40 | 90 | 0 |
| rag | 28 | 0 | 0 | 70 | 40 | 0 | 70 | 100 | 0 | 80 | 80 | 100 | 19 | 0 | 0 | 30 | 0 | 80 | 90 | 70 | 90 |
| agentic-ci | 27 | 0 | 0 | 0 | 0 | 0 | 70 | 100 | 0 | 0 | 80 | 0 | 13 | 60 | 0 | 100 | 0 | 0 | 0 | 90 | 0 |
| client | 24 | 0 | 0 | 20 | 40 | 0 | 70 | 100 | 0 | 80 | 80 | 0 | 10 | 0 | 0 | 30 | 0 | 80 | 40 | 90 | 100 |
| caikit-tgis-serving | 23 | 0 | 0 | 20 | 30 | 0 | 90 | 100 | 70 | 0 | 80 | 100 | 43 | 0 | 0 | 30 | 0 | 0 | 100 | 90 | 0 |
| fips-compliance-checker-claude-code-plugin | 23 | 44 | 0 | 0 | 15 | 80 | 70 | 100 | 0 | 70 | 80 | 0 | 75 | 0 | 0 | 0 | 0 | 0 | 40 | 90 | 0 |
| odh-s2i-project-cds | 18 | 0 | 0 | 20 | 0 | 0 | 90 | 100 | 0 | 0 | 90 | 0 | 13 | 60 | 0 | 0 | 0 | 40 | 40 | 90 | 0 |
| ml-metadata | 17 | 0 | 0 | 20 | 15 | 40 | 30 | 100 | 0 | 80 | 80 | 0 | 38 | 0 | 0 | 30 | 0 | 0 | 50 | 90 | 0 |
| vllm-orchestrator-gateway | 17 | 0 | 0 | 0 | 0 | 0 | 50 | 100 | 70 | 80 | 80 | 0 | 0 | 0 | 0 | 100 | 0 | 80 | 40 | 0 | 0 |
| autofix-skills | 16 | 100 | 50 | 20 | 0 | 0 | 70 | 100 | 0 | 70 | 80 | 0 | 0 | 0 | 0 | 30 | 100 | 80 | 90 | 0 | 0 |
| llama-stack-provider-kft | 16 | 0 | 0 | 70 | 0 | 0 | 90 | 100 | 70 | 50 | 50 | 0 | 0 | 0 | 0 | 30 | 0 | 80 | 0 | 0 | 90 |
| llama-stack-provider-instructlab-train | 14 | 0 | 0 | 20 | 0 | 0 | 90 | 100 | 60 | 50 | 30 | 0 | 0 | 0 | 0 | 30 | 0 | 80 | 0 | 0 | 90 |
| odh-s2i-project-cookiecutter | 13 | 0 | 0 | 0 | 15 | 0 | 90 | 100 | 0 | 0 | 70 | 0 | 50 | 0 | 0 | 0 | 0 | 0 | 0 | 90 | 0 |
| agents | 13 | 56 | 0 | 70 | 70 | 90 | 90 | 100 | 0 | 80 | 80 | 0 | 13 | 0 | 0 | 0 | 0 | 0 | 0 | 50 | 0 |
| odh-gitops | 10 | 0 | 0 | 0 | 30 | 0 | 70 | 100 | 0 | 0 | 80 | 0 | 0 | 0 | 0 | 30 | 100 | 80 | 90 | 0 | 0 |
| skills-registry | 10 | 56 | 0 | 0 | 40 | 0 | 70 | 100 | 0 | 70 | 80 | 0 | 0 | 0 | 0 | 30 | 0 | 0 | 60 | 0 | 0 |
| opendatahub.io | 9 | 0 | 0 | 0 | 0 | 0 | 90 | 100 | 60 | 90 | 90 | 0 | 0 | 0 | 0 | 30 | 0 | 0 | 70 | 0 | 0 |
| odh-konflux-central | 7 | 0 | 0 | 0 | 30 | 0 | 70 | 100 | 0 | 0 | 80 | 0 | 0 | 0 | 0 | 30 | 0 | 80 | 0 | 0 | 0 |
| model-runtimes-agent | 6 | 44 | 0 | 70 | 0 | 0 | 50 | 100 | 0 | 70 | 90 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 40 | 0 | 0 |
| knowledge-skills | 5 | 56 | 0 | 0 | 0 | 0 | 90 | 100 | 0 | 0 | 80 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| llm-d-playbooks | 5 | 0 | 0 | 0 | 40 | 0 | 90 | 100 | 0 | 70 | 80 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| odh-s2i-project-simple | 4 | 0 | 0 | 0 | 0 | 0 | 90 | 100 | 0 | 0 | 70 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 40 | 0 | 0 |
| aiops-infra | 4 | 0 | 0 | 0 | 0 | 0 | 70 | 100 | 0 | 70 | 80 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| dsp-dev-tools | 4 | 0 | 0 | 0 | 40 | 0 | 90 | 100 | 0 | 0 | 80 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 100 |
|
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 85 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 92 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | N/A | Excluded by profile |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | N/A | Excluded by profile |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | N/A | Excluded by profile |
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 92 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 70 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 100 |
|
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 100 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 100 |
|
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 90 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 70 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 70 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 92 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 70 |
|
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 100 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 90 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 100 |
|
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 60 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 80 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 70 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 68 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 60 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 65 |
|
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 100 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 85 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 92 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 55 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 90 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 40 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 80 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 70 |
|
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 75 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 85 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 70 |
|
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 30 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 70 |
|
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 70 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 90 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 70 |
|
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 35 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 80 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 60 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 70 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 70 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 70 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 70 |
|
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 30 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 30 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 10 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 68 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 43 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 80 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 70 |
|
| Code Navigability | Navigate | 5% | 30 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 43 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 80 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 50 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 53 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 70 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 44 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 70 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 95 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 60 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 90 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 100 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 53 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 92 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 55 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 30 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 80 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 80 |
|
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 70 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 60 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 55 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 50 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 55 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 60 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 70 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 80 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 70 |
|
| Code Navigability | Navigate | 5% | 30 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 43 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 60 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 53 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 53 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 60 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 85 |
|
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 20 |
Add '// Code generated' headers to generated files and document which files are auto-generated in CLAUDE.md. |
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 100 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 100 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 55 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 13 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 70 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 100 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 70 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 55 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 13 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 70 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 68 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 50 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 53 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 60 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 80 |
|
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 70 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 53 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 60 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 40 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 25 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 40 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 80 |
|
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 30 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 50 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 10 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 30 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 50 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 10 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 30 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 80 |
|
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 25 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 70 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 100 |
|
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 50 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 10 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 53 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 30 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 40 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 30 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 75 |
|
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 56 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 80 |
|
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 10 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 10 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 55 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 30 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 10 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 100 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 10 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 60 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 60 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 40 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 60 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 30 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 100 |
|
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 60 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 40 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 45 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 50 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 60 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 70 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 70 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 75 |
|
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 70 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 50 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 80 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 10 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 50 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 20 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 60 |
|
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 10 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 50 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 10 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 64 |
|
| One-Command Test Execution | Verify | 11% | 70 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 40 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 40 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 80 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 85 |
|
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 30 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 25 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 70 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 43 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 60 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 40 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 19 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 25 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 43 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 70 |
|
| Linting / Formatting in CI | Submit | 5% | 100 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 90 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 10 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 50 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 40 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 10 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 60 |
|
| Test-to-Source Ratio | Verify | 15% | 53 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 40 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 50 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 35 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 50 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 70 |
|
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 80 |
|
| Bug Report Template Quality | Understand | 8% | 100 |
|
| Structured Logging / Errors | Understand | 3% | 90 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 10 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 13 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 10 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 19 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 100 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 19 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 100 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 85 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 10 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 70 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 25 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 25 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 60 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 80 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 10 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 90 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 80 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 15 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 19 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 19 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 70 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 13 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 10 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 100 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 43 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 100 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 44 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 80 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 75 |
|
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 13 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 40 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 15 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 40 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 30 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 38 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 50 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 50 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 100 |
|
| Bug Report Template Quality | Understand | 8% | 50 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 70 |
|
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 50 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 50 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 30 |
Consider reducing direct dependencies or documenting key dependencies to help AI agents understand the project's dependency surface. |
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 56 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 70 |
|
| Test Fixtures / Sample Data | Understand | 2% | 90 |
|
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 80 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 13 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 50 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 100 |
|
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 90 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 56 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 60 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 90 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 70 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 30 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 44 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 70 |
|
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 50 |
Break large files (>500 lines) into smaller, focused modules. Exclude generated files from linting. |
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 90 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 56 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 70 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 40 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 0 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 70 |
|
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 0 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 40 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 0 |
Add test fixtures or sample data directories (testdata/, fixtures/, examples/) to help AI agents understand expected inputs and reproduce bugs. |
| Code Navigability | Navigate | 5% | 90 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 0 |
Add dependency lockfiles (go.sum, package-lock.json, poetry.lock) and a documented build setup to ensure reproducible builds. |
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 0 |
Create a .github/CODEOWNERS file mapping directories to team members for automated PR review assignment. |
| Test-to-Source Ratio | Verify | 15% | 0 |
Add unit tests for critical code paths. Aim for at least 1 test file per 2 source files. |
| One-Command Test Execution | Verify | 11% | 0 |
Add a 'make test' or 'make unittest' target that runs unit tests without external dependencies. |
| Coverage Configuration | Verify | 3% | 0 |
Configure coverage reporting (e.g., -coverprofile for Go, pytest-cov for Python) and add a Codecov or Coveralls integration. |
| CI Runs Tests on PRs | Verify | 10% | 0 |
Ensure CI workflows triggered by pull_request events include a step that runs tests. |
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 0 |
Add a linting step (golangci-lint, eslint, ruff) to your CI pipeline. |
| Contributing / Dev Guide | Submit | 5% | 0 |
Add CONTRIBUTING.md with build, test, and debug instructions. |
| Test Isolation (unit vs e2e) | Verify | 4% | 0 |
Separate unit tests (no external deps) from integration/e2e tests using build tags or directory structure. |
| Pre-commit / Local Hooks | Verify | 3% | 0 |
Add pre-commit hooks (.pre-commit-config.yaml, husky, lefthook) for fast local feedback on formatting and linting. |
These repos contain no source code (docs, config, governance, etc.) and are excluded from scoring. AI bug-fix readiness assessment is not applicable to non-code repos.
Which phase is the weakest for each repo
An AI agent fixing a bug goes through these phases. Scores show ecosystem average per phase.
| Repository | Score | Level | Languages | |
|---|---|---|---|---|
| codeflare-sdk | 58 | Needs Work | Python, Shell |
Actions that would raise the most scores across the ecosystem, sorted by estimated impact.
| Action | Repos Below 40 | Weight | How to Fix |
|---|---|---|---|
| AI Context Files | 1 repos | 8% | Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | 1 repos | 8% | Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Type Safety / Static Analysis | 1 repos | 3% | Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| PR Template | 1 repos | 2% | Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Structured Logging / Errors | 1 repos | 3% | Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | 1 repos | 3% | Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
The overall score is a weighted average of 20 checks, each scored 0-100. Checks are grouped into 4 phases of an AI bug-fixing workflow:
| Phase | Weight | What it measures |
|---|---|---|
| Understand | 24% | AI Context Files (8%), Bug Report Template Quality (8%), Structured Logging / Errors (3%), Architecture Documentation (3%), Test Fixtures / Sample Data (2%) |
| Navigate | 17% | Code Navigability (5%), Generated Code Ratio (2%), Build / Dependency Setup (5%), Type Safety / Static Analysis (3%), Dependency Complexity (2%) |
| Verify | 46% | Test-to-Source Ratio (15%), One-Command Test Execution (11%), Coverage Configuration (3%), CI Runs Tests on PRs (10%), Test Isolation (unit vs e2e) (4%), Pre-commit / Local Hooks (3%) |
| Submit | 13% | Code Ownership (CODEOWNERS) (1%), PR Template (2%), Linting / Formatting in CI (5%), Contributing / Dev Guide (5%) |
Verify Phase Gate: If a repo's average Verify score is below 50, the overall score receives a smooth penalty multiplier that scales linearly from x0.4 (verify avg = 0) to x1.0 (verify avg = 50). This reflects that without test infrastructure, autonomous bug fixing is not viable.
Readiness levels: Ready (80+), Partially Ready (60-79), Needs Work (40-59), Not Ready (<40).
| Check | Avg Score | Weight | |
|---|---|---|---|
| AI Context Files | 0 | 8% | |
| Bug Report Template Quality | 0 | 8% | |
| Type Safety / Static Analysis | 0 | 3% | |
| PR Template | 0 | 2% | |
| Structured Logging / Errors | 20 | 3% | |
| Architecture Documentation | 30 | 3% | |
| Test Fixtures / Sample Data | 60 | 2% | |
| Build / Dependency Setup | 60 | 5% | |
| One-Command Test Execution | 60 | 11% | |
| Code Navigability | 70 | 5% | |
| Test-to-Source Ratio | 75 | 15% | |
| Dependency Complexity | 80 | 2% | |
| Coverage Configuration | 80 | 3% | |
| Linting / Formatting in CI | 80 | 5% | |
| Contributing / Dev Guide | 80 | 5% | |
| Test Isolation (unit vs e2e) | 90 | 4% | |
| Pre-commit / Local Hooks | 90 | 3% | |
| Generated Code Ratio | 100 | 2% | |
| Code Ownership (CODEOWNERS) | 100 | 1% | |
| CI Runs Tests on PRs | 100 | 10% |
Green (80+) = ready, Yellow (40-79) = partial, Red (<40) = gap.
| Repository | Score | AI Context Files | Bug Report Template Quality | Structured Logging / Errors | Architecture Documentation | Test Fixtures / Sample Data | Code Navigability | Generated Code Ratio | Build / Dependency Setup | Type Safety / Static Analysis | Dependency Complexity | Code Ownership (CODEOWNERS) | Test-to-Source Ratio | One-Command Test Execution | Coverage Configuration | CI Runs Tests on PRs | PR Template | Linting / Formatting in CI | Contributing / Dev Guide | Test Isolation (unit vs e2e) | Pre-commit / Local Hooks |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| codeflare-sdk | 58 | 0 | 0 | 20 | 30 | 60 | 70 | 100 | 60 | 0 | 80 | 100 | 75 | 60 | 80 | 100 | 0 | 80 | 80 | 90 | 90 |
| Check | Phase | Weight | Score | Evidence & Recommendation |
|---|---|---|---|---|
| AI Context Files | Understand | 8% | 0 |
Create an AGENTS.md at the repo root describing architecture, how to build, test, and debug. For Claude users, a CLAUDE.md is also supported. Other recognized files: COPILOT.md, .cursorrules, CONTEXT.md. |
| Bug Report Template Quality | Understand | 8% | 0 |
Add .github/ISSUE_TEMPLATE/bug_report.yml with required fields: reproduction steps, expected/actual behavior, environment, and error logs. Alternatively, if using Jira for bug tracking, document the process in CONTRIBUTING.md with a Jira link and bug reporting instructions. |
| Structured Logging / Errors | Understand | 3% | 20 |
Adopt a structured logging library (e.g., logr/zap for Go, structlog for Python, Sentry for frontend) and wrap errors with context. |
| Architecture Documentation | Understand | 3% | 30 |
Add architecture documentation (ARCHITECTURE.md, docs/design/, or module-level READMEs) to help AI agents understand codebase structure. |
| Test Fixtures / Sample Data | Understand | 2% | 60 |
|
| Code Navigability | Navigate | 5% | 70 |
|
| Generated Code Ratio | Navigate | 2% | 100 |
|
| Build / Dependency Setup | Navigate | 5% | 60 |
|
| Type Safety / Static Analysis | Navigate | 3% | 0 |
Enable type checking (mypy for Python, tsconfig strict for TypeScript) or add type annotations to help AI agents understand function contracts. |
| Dependency Complexity | Navigate | 2% | 80 |
|
| Code Ownership (CODEOWNERS) | Submit | 1% | 100 |
|
| Test-to-Source Ratio | Verify | 15% | 75 |
|
| One-Command Test Execution | Verify | 11% | 60 |
|
| Coverage Configuration | Verify | 3% | 80 |
|
| CI Runs Tests on PRs | Verify | 10% | 100 |
|
| PR Template | Submit | 2% | 0 |
Add .github/PULL_REQUEST_TEMPLATE.md with a testing checklist. |
| Linting / Formatting in CI | Submit | 5% | 80 |
|
| Contributing / Dev Guide | Submit | 5% | 80 |
|
| Test Isolation (unit vs e2e) | Verify | 4% | 90 |
|
| Pre-commit / Local Hooks | Verify | 3% | 90 |
|
| Org | Repos | Avg Score | Ready | Partially Ready | Needs Work | Not Ready |
|---|---|---|---|---|---|---|
| opendatahub-io | 122 | 54 | 18 | 47 | 24 | 33 |
| project-codeflare | 1 | 58 | 0 | 0 | 1 | 0 |