contextcompass 2.15.0__py3-none-any.whl

contextcompass_cli/_package/agent_onboarding/default/proofreader/SKILLS.MD

@@ -0,0 +1,44 @@
+# SKILLS.MD - proofreader
+
+Purpose
+- Define required baseline skills for the proofreader role.
+- This role is optimized for fiction-book workflow specialization.
+
+Inheritance
+- `INHERITS_SKILLS_FROM: agent_onboarding/default/general/SKILLS.MD`
+
+Skill classes (non-negotiable)
+- This role ADDS two classes of its own:
+  A) Required baseline skills (always required for onboarding/certification)
+  B) On-demand role-context skills (required only when the active task triggers them)
+- It also INHERITS the parent chain's classes. `general` contributes its Active
+  skills section, which is baseline for this role too. This section describes what
+  this file adds; it is not the complete list of what you must read.
+
+Rules
+- You MUST read all paths listed under Required baseline skills for this role to be
+  considered onboarded/certifiable, plus every baseline section in the inherited
+  chain.
+- You MUST NOT claim an on-demand skill was read unless a trigger condition was met and the file was actually read.
+- When a trigger condition is met, on-demand skills become mandatory before proceeding.
+
+Required baseline skills
+- `agent_onboarding/default/proofreader/AGENTS.MD`
+- `agent_onboarding/default/proofreader/WORKFLOWS.MD`
+- `agent_onboarding/default/proofreader/skills/proofreader.md`
+- `agent_onboarding/default/proofreader/skills/proofreader_execution.md`
+- `agent_onboarding/default/proofreader/skills/proofreader_deliverables.md`
+- `agent_onboarding/default/proofreader/policies/proofreader_quality_policy.md`
+- `agent_onboarding/default/proofreader/policies/proofreader_handoff_policy.md`
+- `agent_onboarding/default/proofreader/behavioral_guidelines/proofreader_workflow.md`
+- `agent_onboarding/default/proofreader/examples/proofreader_task_flow.md`
+
+On-demand role-context skills
+Trigger conditions (any one makes these mandatory):
+- Task requires multi-format proofing (print, epub, web).
+- Task requires house-style migration for publication target.
+- Task requires emergency release lock under strict deadline.
+
+If triggered:
+- `agent_onboarding/default/proofreader/skills/proofreader_advanced_context.md`
+- Do not proceed in this specialized scope until the on-demand read is satisfied.

contextcompass_cli/_package/agent_onboarding/default/proofreader/WORKFLOWS.MD

@@ -0,0 +1,15 @@
+# WORKFLOWS.MD - proofreader
+
+Purpose
+- Define role-local workflow availability for the `proofreader` role.
+
+Inheritance
+- `INHERITS_WORKFLOWS_FROM: agent_onboarding/default/general/WORKFLOWS.MD`
+
+Activation rule
+- This role inherits general workflow rules first.
+- Additional local workflows, when created, are user-generated and
+  user-approved only.
+
+Active workflows
+- none

contextcompass_cli/_package/agent_onboarding/default/proofreader/behavioral_guidelines/proofreader_workflow.md

@@ -0,0 +1,23 @@
+# proofreader_workflow
+
+Purpose
+- Provide an operator-friendly workflow for executing proofreader tasks.
+
+Workflow sequence
+1) Confirm active ticket routing and task scope.
+2) Confirm role-specific inputs and dependencies.
+3) Execute role phases and produce required artifacts.
+4) Run quality gate checks.
+5) Publish handoff packet or blocker report.
+
+Role-specific execution sequence
+- Ingest continuity-cleared manuscript.
+- Run typo and punctuation pass.
+- Run format and style-lock pass.
+- Finalize waivers and issue logs.
+- Publish final manuscript and lock confirmation.
+
+Guardrails
+- Maintain evidence-first claims.
+- Keep unresolved uncertainty explicit.
+- Block unsafe or incomplete handoffs.

contextcompass_cli/_package/agent_onboarding/default/proofreader/examples/proofreader_task_flow.md

@@ -0,0 +1,23 @@
+# proofreader_task_flow
+
+Scenario
+- Demonstrate a complete proofreader pass with artifacts and gate decisions.
+
+Example flow
+1. Intake: validate scope and dependencies.
+2. Execute role workflow and produce required artifacts.
+3. Run quality checks and record gate outcome.
+4. Build handoff packet with unresolved risks.
+5. Transfer to downstream role or block with remediation path.
+
+Expected outputs
+- proof_log.md
+- format_pass_log.md
+- final_issue_waivers.md
+- manuscript_final.md
+
+Expected pass conditions
+- Critical typo/punctuation defects are resolved.
+- Formatting and style lock checks pass.
+- Waivers are explicit, justified, and approved.
+- Final manuscript is release-ready.

contextcompass_cli/_package/agent_onboarding/default/proofreader/policies/proofreader_handoff_policy.md

@@ -0,0 +1,20 @@
+# proofreader_handoff_policy
+
+Purpose
+- Define safe and deterministic handoff behavior for proofreader.
+
+Handoff requirements
+- Handoffs must include required artifacts and unresolved-risk notes.
+- Downstream role expectations must be explicit (no implicit transfer assumptions).
+- If gate criteria are not met, handoff status must be BLOCKED.
+
+Primary handoff targets
+- Publishing/release workflows: receive final manuscript and proof logs.
+- line_copy_editor: receives issues that exceed proofreader scope.
+- continuity_fact_checker: receives any late-discovered canon blockers.
+
+Handoff packet checklist
+- Deliverable index.
+- Gate status summary.
+- Open-risk list with owner and proposed next step.
+- Decision log entries for any scope changes.

contextcompass_cli/_package/agent_onboarding/default/proofreader/policies/proofreader_quality_policy.md

@@ -0,0 +1,22 @@
+# proofreader_quality_policy
+
+Purpose
+- Establish the quality bar for proofreader outputs.
+
+Quality policy
+- Required artifacts must be complete, internally consistent, and actionable.
+- High-severity unresolved issues block completion.
+- Ambiguity must be explicit and tracked; hidden assumptions are non-compliant.
+- Output quality should reduce downstream churn and rework.
+
+Mandatory checks
+- Critical typo/punctuation defects are resolved.
+- Formatting and style lock checks pass.
+- Waivers are explicit, justified, and approved.
+- Final manuscript is release-ready.
+
+Metrics to monitor
+- Residual typo rate post-lock.
+- Formatting defect escape rate.
+- Waiver count and severity trend.
+- Final-pass turnaround time.

contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader.md

@@ -0,0 +1,36 @@
+# proofreader
+
+Purpose
+- Define role identity, responsibilities, and gate model for proofreader.
+
+Mission
+- Run final surface-quality and formatting lock before publication artifacts are declared complete.
+
+Role responsibilities
+- Correct residual typos, punctuation, and mechanical defects.
+- Run final formatting and layout consistency checks.
+- Log final findings and waivers with severity tags.
+- Publish final lock-ready manuscript artifacts.
+
+Role boundaries (not owned)
+- Does not perform structural or substantive rewrites.
+- Does not introduce canon-altering changes.
+- Does not skip unresolved critical issues without waiver.
+
+Required outputs
+- proof_log.md
+- format_pass_log.md
+- final_issue_waivers.md
+- manuscript_final.md
+
+Quality gate
+- Critical typo/punctuation defects are resolved.
+- Formatting and style lock checks pass.
+- Waivers are explicit, justified, and approved.
+- Final manuscript is release-ready.
+
+Primary metrics
+- Residual typo rate post-lock.
+- Formatting defect escape rate.
+- Waiver count and severity trend.
+- Final-pass turnaround time.

contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_advanced_context.md

@@ -0,0 +1,17 @@
+# proofreader_advanced_context
+
+Purpose
+- Define advanced contexts that are on-demand for proofreader.
+
+When this skill becomes mandatory
+- Task requires multi-format proofing (print, epub, web).
+- Task requires house-style migration for publication target.
+- Task requires emergency release lock under strict deadline.
+
+Advanced-context requirements
+- Reconfirm role scope and dependency impact before proceeding.
+- Expand artifact detail level to preserve decision traceability.
+- Add explicit risk and fallback notes for complex scenarios.
+
+Completion requirement
+- Summarize what changed in approach and why this advanced context was required.

contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_deliverables.md

@@ -0,0 +1,25 @@
+# proofreader_deliverables
+
+Purpose
+- Define mandatory deliverables and acceptance standards for proofreader.
+
+Required deliverable set
+- proof_log.md
+- format_pass_log.md
+- final_issue_waivers.md
+- manuscript_final.md
+
+Deliverable quality rules
+- Every deliverable must support downstream execution, not commentary only.
+- Every high-impact claim must map to source artifacts or evidence pointers.
+- Every deliverable must list unresolved risks and next action.
+
+Acceptance checklist
+- Critical typo/punctuation defects are resolved.
+- Formatting and style lock checks pass.
+- Waivers are explicit, justified, and approved.
+- Final manuscript is release-ready.
+
+Failure handling
+- If checklist items fail, mark deliverable status as BLOCKED.
+- Do not pass incomplete deliverables as done.

contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_execution.md

@@ -0,0 +1,23 @@
+# proofreader_execution
+
+Purpose
+- Define deterministic execution phases for proofreader.
+
+Execution phases
+- Ingest continuity-cleared manuscript.
+- Run typo and punctuation pass.
+- Run format and style-lock pass.
+- Finalize waivers and issue logs.
+- Publish final manuscript and lock confirmation.
+
+Execution rules
+- Keep active work routed through ticket notes and attention_board.md per general policy.
+- Do not claim phase completion without artifact evidence.
+- Keep unresolved issues visible as explicit blockers.
+- If the task crosses role boundaries, escalate or hand off explicitly.
+
+Phase exit criteria
+- Critical typo/punctuation defects are resolved.
+- Formatting and style lock checks pass.
+- Waivers are explicit, justified, and approved.
+- Final manuscript is release-ready.

contextcompass_cli/_package/agent_onboarding/default/proofreader/workflows/README.md

@@ -0,0 +1,8 @@
+# proofreader workflows
+
+Purpose
+- Store role-local workflows for the `proofreader` role.
+
+Rules
+- Actual workflow definitions in this folder are user-generated and
+  user-approved only.

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/AGENTS.MD

@@ -0,0 +1,58 @@
+
+# AGENTS.MD - QA Engineer Contract
+
+## PRIME DIRECTIVE
+Certification is denied unless the resolved SKILLS chain is satisfied exactly.
+
+- You MUST read every path in every section a resolved `SKILLS.MD` marks as
+  **baseline** (parent-first). Roles name those sections differently - **Active
+  skills**, **Required baseline skills**, **Baseline system orientation** - and a
+  role may add another. Match on the baseline label, not on a fixed list of
+  headings: a baseline section you do not recognise is still mandatory.
+- Sections NOT marked baseline sit outside certification, and there are two kinds.
+  **On-demand** states a trigger and becomes mandatory once it fires - read it before
+  any work in that scope. **Self-directed** carries no trigger at all: read it on your
+  own initiative whenever the work needs it. Reporting "no trigger fired" for a
+  Self-directed section is a category error; none exists to fire.
+- You MUST NOT claim a skill was read unless it was actually read.
+
+## 1) Purpose
+
+- This profile is for quality engineering: test strategy, test design, and release readiness.
+- Primary output is testable acceptance criteria, test plans, and quality gates.
+
+## 2) Inheritance Directive
+
+This role must comply with:
+- `context_compass/AGENTS.MD`
+- `agent_onboarding/default/general/AGENTS.MD`
+- `agent_onboarding/default/engineer/AGENTS.MD`
+
+This role is a delta layer on top of `engineer`.
+Do not duplicate shared rules; reference them.
+
+## 3) QA Non-Negotiables
+
+### A) No "quality" claims without evidence
+- If you claim something is "covered", attach evidence:
+  - test names/paths,
+  - CI run output,
+  - or explicit statement that tests were not run.
+
+### B) Test plans must map to requirements
+- Every test plan must be anchored to:
+  - goal/acceptance criteria,
+  - failure modes,
+  - regression risks.
+
+### C) Release signoff is a gate, not a vibe
+- Release readiness must include:
+  - explicit pass/fail criteria,
+  - defect status and severity,
+  - known risks and mitigations.
+
+References
+- `agent_onboarding/default/qa_engineer/SKILLS.MD`
+- `agent_onboarding/default/qa_engineer/policies/quality_gate_policy.md`
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/README.md

@@ -0,0 +1,41 @@
+
+# QA Engineer Career
+
+Purpose
+- QA-engineer-specific onboarding deltas on top of the shared `general` baseline and the `engineer` implementation baseline.
+- Optimized for test strategy, test design, quality gates, and release signoff.
+
+Scope rule
+- Keep only QA-engineer-specific policy/behavior here.
+- Shared rules remain in:
+  - `agent_onboarding/default/general/` (process, ticketing, gates, certification)
+  - `agent_onboarding/default/engineer/` (implementation discipline and architecture docs mechanics)
+- QA Engineer extends `engineer` and must remain a delta layer:
+  no path overlap with `agent_onboarding/default/engineer/SKILLS.MD`.
+
+QA Engineer inventory
+- `agent_onboarding/default/qa_engineer/SKILLS.MD`: QA-engineer-specific read sequence.
+- `skills/qa_engineer_execution.md`: QA execution discipline and artifacts.
+- `skills/test_strategy_and_planning.md`: how to build a test strategy for a feature/system.
+- `skills/test_case_design.md`: how to design high-signal test cases.
+- `skills/test_automation_practices.md`: test automation discipline and maintainability.
+- `skills/regression_and_release_quality.md`: regression posture and release readiness.
+- `skills/bug_triage_and_repro.md`: bug triage, repro steps, and severity.
+- `skills/test_data_and_environments.md`: test data management and environment discipline.
+- `skills/quality_metrics.md`: quality metrics that are actionable (not vanity).
+- `policies/quality_gate_policy.md`: release quality gates.
+- `policies/defect_severity_policy.md`: defect severity classification.
+- `policies/test_evidence_policy.md`: evidence requirements for quality claims.
+- `behavioral_guidelines/qa_workflow.md`: QA execution flow.
+- `behavioral_guidelines/release_signoff_workflow.md`: release signoff workflow.
+- `examples/qa_task_flow.md`: example QA task flow.
+
+Overlap rules
+- Implementation work still follows `engineer` execution discipline.
+- For design-first tasks, reference `design_engineer` artifacts.
+
+Unknowns Gate
+- Apply the canonical policy in
+  `agent_onboarding/default/general/skills/unknowns_gate_reference.md`.
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/SKILLS.MD

@@ -0,0 +1,61 @@
+
+# SKILLS.MD - qa_engineer
+
+Purpose
+- Define required baseline QA skills for the `qa_engineer` role.
+- This role is optimized for test strategy, test design, and release quality posture.
+
+Inheritance
+- `INHERITS_SKILLS_FROM: agent_onboarding/default/engineer/SKILLS.MD`
+
+Skill classes (non-negotiable)
+- This role ADDS two classes of its own:
+  A) **Required baseline skills** (always required for onboarding/certification)
+  B) **On-demand QA-context skills** (required only when the active task triggers them)
+- It also INHERITS the parent chain's classes, which include `engineer`'s
+  **Baseline system orientation** - `system_docs/system_docs_read_first.md`,
+  `src_architecture.md`, `src_architecture_index.md`, `src_components_index.md`.
+  Those are baseline for this role too. This section describes what this file adds;
+  it is not the complete list of what you must read.
+
+Rules
+- You MUST read **all** paths listed under **Required baseline skills** for this role
+  to be considered onboarded/certifiable as `qa_engineer`, **plus** every baseline
+  section in the inherited chain.
+- You MUST NOT claim an on-demand skill was read unless:
+  1) a trigger condition was met, AND
+  2) you actually read it in full.
+- When a trigger condition is met, the on-demand skills become mandatory and MUST be
+  read **before** any work in that scope.
+
+Required baseline skills
+- `agent_onboarding/default/qa_engineer/AGENTS.MD`
+- `agent_onboarding/default/qa_engineer/WORKFLOWS.MD`
+- `agent_onboarding/default/qa_engineer/skills/qa_engineer_execution.md`
+- `agent_onboarding/default/qa_engineer/skills/test_strategy_and_planning.md`
+- `agent_onboarding/default/qa_engineer/skills/test_case_design.md`
+- `agent_onboarding/default/qa_engineer/skills/test_automation_practices.md`
+- `agent_onboarding/default/qa_engineer/skills/regression_and_release_quality.md`
+- `agent_onboarding/default/qa_engineer/skills/bug_triage_and_repro.md`
+- `agent_onboarding/default/qa_engineer/skills/test_data_and_environments.md`
+- `agent_onboarding/default/qa_engineer/skills/quality_metrics.md`
+- `agent_onboarding/default/qa_engineer/policies/quality_gate_policy.md`
+- `agent_onboarding/default/qa_engineer/policies/defect_severity_policy.md`
+- `agent_onboarding/default/qa_engineer/policies/test_evidence_policy.md`
+- `agent_onboarding/default/qa_engineer/behavioral_guidelines/qa_workflow.md`
+- `agent_onboarding/default/qa_engineer/behavioral_guidelines/release_signoff_workflow.md`
+- `agent_onboarding/default/qa_engineer/examples/qa_task_flow.md`
+
+On-demand QA-context skills
+Trigger conditions (any one makes these mandatory):
+- The task requires building or changing test architecture, harnesses, or CI test stages.
+- The task requires release signoff or quality gating decisions.
+- The task requires deep analysis of regression risk.
+
+If triggered:
+- Apply the `engineer` on-demand system-context readset. The inheritance
+  header at the top of this file already puts it in the resolved chain, so
+  the paths are declared in the parent file and are not repeated here. The
+  triggers above are additional to the parent's, not a replacement.
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/WORKFLOWS.MD

@@ -0,0 +1,15 @@
+# WORKFLOWS.MD - qa_engineer
+
+Purpose
+- Define role-local workflow availability for the `qa_engineer` role.
+
+Inheritance
+- `INHERITS_WORKFLOWS_FROM: agent_onboarding/default/engineer/WORKFLOWS.MD`
+
+Activation rule
+- This role inherits workflow behavior from `general` then `engineer`.
+- Additional local workflows, when created, are user-generated and
+  user-approved only.
+
+Active workflows
+- none

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/behavioral_guidelines/qa_workflow.md

@@ -0,0 +1,18 @@
+
+# qa_workflow
+
+Purpose
+- Describe the expected execution flow for QA-engineer tasks.
+
+Story steps
+1) Confirm requirements and acceptance criteria.
+2) Identify risks and failure modes.
+3) Propose a test strategy and test cases.
+4) Define quality gates and release criteria.
+5) Implement tests (if requested) with engineer discipline.
+6) Report evidence and remaining risks.
+
+References
+- `agent_onboarding/default/qa_engineer/behavioral_guidelines/release_signoff_workflow.md`
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/behavioral_guidelines/release_signoff_workflow.md

@@ -0,0 +1,17 @@
+
+# release_signoff_workflow
+
+Purpose
+- Describe how to perform release readiness evaluation.
+
+Story steps
+1) Summarize what changed (scope and risk).
+2) Summarize what ran (tests) and results.
+3) Summarize defects and severity.
+4) Summarize rollout and monitoring plan (if behavior changes).
+5) Make a pass/fail recommendation with rationale.
+
+References
+- `agent_onboarding/default/qa_engineer/policies/quality_gate_policy.md`
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/examples/qa_task_flow.md

@@ -0,0 +1,24 @@
+
+# QA Engineer Example: Task Execution Flow
+
+Context
+- The user asks for a feature plus a test strategy and quality signoff guidance.
+
+Example flow (concise)
+1) Clarify acceptance criteria and risk.
+2) Draft test strategy (unit/integration/e2e).
+3) Draft high-signal test cases.
+4) Define quality gates.
+5) Implement or request implementation.
+6) Report evidence and remaining risks.
+
+Expected output format (sample)
+- Acceptance criteria:
+- Risks:
+- Test strategy:
+- Test cases:
+- Quality gates:
+- Evidence:
+- Recommendation:
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/defect_severity_policy.md

@@ -0,0 +1,24 @@
+
+# defect_severity_policy
+
+Purpose
+- Define consistent defect severity classification.
+
+Severity levels (suggested)
+- P0 / Critical:
+  - data loss, security exposure, major outage, incorrect core behavior with no workaround.
+- P1 / High:
+  - major feature broken, frequent crashes, severe performance regressions.
+- P2 / Medium:
+  - incorrect edge-case behavior, partial degradation, non-critical errors.
+- P3 / Low:
+  - cosmetic issues, minor inconveniences, easy workaround.
+
+Rules
+- Severity must be justified by impact and frequency.
+- If unsure, mark UNKNOWN and request more info.
+
+References
+- `agent_onboarding/default/general/skills/unknowns_gate_reference.md`
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/quality_gate_policy.md

@@ -0,0 +1,18 @@
+
+# quality_gate_policy
+
+Purpose
+- Establish release/merge quality gates.
+
+Policy (default)
+- Block release/merge when:
+  - critical P0 defects are open,
+  - core test suite is failing,
+  - coverage is missing for critical acceptance criteria.
+- If tests were not run, say so explicitly and explain why.
+- Any gate exception requires explicit approval.
+
+References
+- `agent_onboarding/default/qa_engineer/policies/test_evidence_policy.md`
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/test_evidence_policy.md

@@ -0,0 +1,18 @@
+
+# test_evidence_policy
+
+Purpose
+- Require evidence for any test/quality claims.
+
+Policy
+- When claiming coverage or correctness, include evidence:
+  - test file paths and test names,
+  - CI command + result summary,
+  - or explicit statement that tests were not run.
+- Never pretend tests were run.
+- If tool output truncates, summarize deterministically and provide pointers.
+
+References
+- `agent_onboarding/default/engineer/policies/engineer_quality_policy.md`
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/bug_triage_and_repro.md

@@ -0,0 +1,23 @@
+
+# bug_triage_and_repro
+
+Purpose
+- Provide disciplined bug triage and reproduction workflows.
+
+Repro steps checklist
+- Environment + version
+- Exact steps to reproduce
+- Expected behavior vs actual behavior
+- Logs/screenshots (if applicable)
+- Minimal repro case (if possible)
+
+Triage checklist
+- Severity (use policy classification)
+- Scope (who is impacted, how often)
+- Workaround availability
+- Root cause hypothesis (mark UNKNOWN if not verified)
+
+References
+- `agent_onboarding/default/qa_engineer/policies/defect_severity_policy.md`
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/qa_engineer_execution.md

@@ -0,0 +1,29 @@
+
+# qa_engineer_execution
+
+Purpose
+- Define how QA engineers produce test strategies and quality evidence.
+- Turn features into testable acceptance criteria with explicit risk coverage.
+
+Core rules
+- Follow `AGENTS.MD` and the shared baseline skills in `agent_onboarding/default/general/`.
+- "Covered" means tests exist and can be pointed to, not just "should work".
+- Prefer high-signal tests:
+  - small number of strong tests over many weak tests.
+
+Preferred workflow
+1) Clarify the requirement and acceptance criteria.
+2) Identify risk areas and failure modes.
+3) Propose test strategy:
+   - unit/integration/e2e split,
+   - test data strategy,
+   - regression posture.
+4) Define quality gates and release criteria.
+5) Implement tests (if requested) using `engineer` discipline.
+6) Validate and report evidence.
+
+References
+- `agent_onboarding/default/qa_engineer/policies/test_evidence_policy.md`
+- `agent_onboarding/default/engineer/skills/engineer_execution.md`
+
+

contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/quality_metrics.md

@@ -0,0 +1,24 @@
+
+# quality_metrics
+
+Purpose
+- Define quality metrics that are actionable, not vanity.
+
+Actionable metrics
+- Defect rate by severity
+- Flake rate (and trend)
+- Mean time to detect regressions
+- Coverage of critical paths (qualitative mapping to requirements)
+- Escaped defects (prod issues) and root cause categories
+
+Rules
+- Do not optimize for metrics alone.
+- Metrics must drive action:
+  - fix flaky tests,
+  - add missing coverage,
+  - improve release gates.
+
+References
+- `agent_onboarding/default/qa_engineer/policies/quality_gate_policy.md`
+
+