contextcompass 2.15.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- contextcompass-2.15.0.dist-info/METADATA +673 -0
- contextcompass-2.15.0.dist-info/RECORD +452 -0
- contextcompass-2.15.0.dist-info/WHEEL +4 -0
- contextcompass-2.15.0.dist-info/entry_points.txt +2 -0
- contextcompass-2.15.0.dist-info/licenses/LICENSE +21 -0
- contextcompass_cli/__init__.py +74 -0
- contextcompass_cli/__main__.py +195 -0
- contextcompass_cli/_package/AGENTS.MD +310 -0
- contextcompass_cli/_package/CONTEXT_COMPACTION.md +110 -0
- contextcompass_cli/_package/MANIFEST.md +485 -0
- contextcompass_cli/_package/PROFILE_CLASS_CREATION_GUIDE.md +426 -0
- contextcompass_cli/_package/README.md +266 -0
- contextcompass_cli/_package/SKILLS.MD +144 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/AGENTS.MD +54 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/README.md +43 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/behavioral_guidelines/continuity_fact_checker_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/examples/continuity_fact_checker_task_flow.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/policies/continuity_fact_checker_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/policies/continuity_fact_checker_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker.md +37 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_deliverables.md +26 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/AGENTS.MD +85 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/README.md +62 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/SKILLS.MD +74 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/behavioral_guidelines/design_engineer_workflow.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/behavioral_guidelines/design_validation_and_handoff.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/examples/adr_example.md +40 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/examples/design_task_flow.md +33 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/decision_record_policy.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/design_quality_policy.md +30 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/design_review_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/system_document_quality_rubric.md +236 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/adr_and_decision_hygiene.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/api_and_interface_design.md +36 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_contexts.md +40 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_patch_contracts.md +43 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_tradeoffs.md +33 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/code_description_patch_contracts.md +46 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/component_patch_contracts.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/data_modeling.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/decomposition_and_boundaries.md +42 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/design_engineer_execution.md +65 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/design_review_protocol.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/nonfunctional_requirements.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/patch_framework_design.md +79 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/requirements_to_architecture.md +39 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/src_architecture_instructions.md +347 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/src_components_instructions.md +405 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/system_design_method.md +45 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/tests_architecture_instructions.md +375 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/tests_components_instructions.md +406 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/AGENTS.MD +53 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/README.md +42 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/behavioral_guidelines/developmental_editor_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/examples/developmental_editor_task_flow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/policies/developmental_editor_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/policies/developmental_editor_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor.md +36 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_deliverables.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/AGENTS.MD +54 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/README.md +43 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/behavioral_guidelines/draft_writer_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/examples/draft_writer_task_flow.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/policies/draft_writer_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/policies/draft_writer_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer.md +37 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_deliverables.md +26 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/AGENTS.MD +493 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/README.md +53 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/SKILLS.MD +263 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/behavioral_guidelines/engineer_workflow.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/behavioral_guidelines/task_execution_and_validation.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/examples/artifact_workflow.md +104 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/examples/eng_task_flow.md +30 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/policies/ctx_autonomy_policy.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/policies/ctx_autonomy_rubric.md +161 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/policies/engineer_quality_policy.md +33 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/context_protocol.md +70 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/documentation_standards.md +120 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/engineer_execution.md +62 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/package_maintenance.md +195 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/patch_artifact_consumption.md +68 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/patch_framework_gating.md +72 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/src_graph_generation.md +341 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/src_graph_usage.md +161 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/staleness_protocol.md +49 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/system_document_build.md +360 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/system_orientation.md +83 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/technical_expertise.md +48 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/workflows/README.md +9 -0
- contextcompass_cli/_package/agent_onboarding/default/general/AGENTS.MD +283 -0
- contextcompass_cli/_package/agent_onboarding/default/general/README.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/general/SKILLS.MD +92 -0
- contextcompass_cli/_package/agent_onboarding/default/general/WORKFLOWS.MD +23 -0
- contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/README.md +12 -0
- contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/agent_lifecycle_and_heartbeat.md +37 -0
- contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/onboarding_summary.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/work_intake_and_execution.md +44 -0
- contextcompass_cli/_package/agent_onboarding/default/general/policies/policy_skills.md +174 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/active_documentation.md +86 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/active_pointerboard.md +81 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_identity.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_lifecycle.md +21 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_stance.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/career_selection.md +83 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/compaction_requirements.md +147 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/configuration_standards.md +72 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/context_compaction.md +104 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/context_gold.md +31 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/context_management.md +79 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/context_window_budget.md +64 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/execution_contract.md +234 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/general.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/llm_full_usage.md +111 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/mailbox_protocol.md +85 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/memory_management.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/mrp_policy.md +40 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/package_upgrade.md +135 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/reactive_documentation.md +105 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/repo_topology.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/role_local_workflows.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/security_and_secrets.md +46 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/self_certification.md +49 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/ticket_closure_attention_sync.md +57 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/ticket_microcycle.md +44 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/ticketing.md +175 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/ticketing_skill_contract.md +52 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/unknowns_gate_reference.md +66 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/user_approved_certification.md +32 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/workflow.md +289 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/README.md +9 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/cleanup_context_compass.md +205 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/role_creation.md +39 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/start_context_compass_work.md +102 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/sync_attention_board.md +91 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/turn_in_selected_tickets.md +95 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/workflow_creation.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/AGENTS.MD +53 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/README.md +42 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/behavioral_guidelines/line_copy_editor_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/examples/line_copy_editor_task_flow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/policies/line_copy_editor_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/policies/line_copy_editor_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor.md +36 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_deliverables.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/new/AGENTS.MD +79 -0
- contextcompass_cli/_package/agent_onboarding/default/new/README.md +54 -0
- contextcompass_cli/_package/agent_onboarding/default/new/SKILLS.MD +35 -0
- contextcompass_cli/_package/agent_onboarding/default/new/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/new/behavioral_guidelines/user_onboarding_flow.md +52 -0
- contextcompass_cli/_package/agent_onboarding/default/new/policies/new_onboarding_policy.md +59 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/configuration_map_guide.md +83 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/first_time_profile_setup.md +60 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/new.md +54 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/onboarding_completion_and_next_step.md +54 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/profile_model_explained.md +120 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/system_overview_for_user.md +51 -0
- contextcompass_cli/_package/agent_onboarding/default/new/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/AGENTS.MD +63 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/README.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/SKILLS.MD +62 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/behavioral_guidelines/incident_workflow.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/behavioral_guidelines/platform_engineer_workflow.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/examples/platform_task_flow.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/operational_safety_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/platform_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/production_change_management_policy.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/ci_cd_and_release.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/deployment_and_environments.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/incident_response_and_runbooks.md +35 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/infrastructure_as_code.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/observability_and_monitoring.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/performance_capacity_cost.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/platform_engineer_execution.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/platform_security_basics.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/AGENTS.MD +53 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/README.md +42 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/behavioral_guidelines/proofreader_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/examples/proofreader_task_flow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/policies/proofreader_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/policies/proofreader_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader.md +36 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_deliverables.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/AGENTS.MD +58 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/README.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/SKILLS.MD +61 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/behavioral_guidelines/qa_workflow.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/behavioral_guidelines/release_signoff_workflow.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/examples/qa_task_flow.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/defect_severity_policy.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/quality_gate_policy.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/test_evidence_policy.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/bug_triage_and_repro.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/qa_engineer_execution.md +29 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/quality_metrics.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/regression_and_release_quality.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_automation_practices.md +30 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_case_design.md +27 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_data_and_environments.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_strategy_and_planning.md +31 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/AGENTS.MD +55 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/README.md +44 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/behavioral_guidelines/researcher_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/examples/researcher_task_flow.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/policies/researcher_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/policies/researcher_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_deliverables.md +27 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/AGENTS.MD +55 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/README.md +43 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/SKILLS.MD +62 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/behavioral_guidelines/security_signoff_and_escalation.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/behavioral_guidelines/security_workflow.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/examples/security_review_flow.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/risk_acceptance_policy.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/secrets_and_keys_policy.md +19 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/security_review_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/authn_authz_basics.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/dependency_and_supply_chain.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/incident_response_security.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/logging_audit_privacy.md +16 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/secure_architecture_review.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/secure_coding_review.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/security_engineer_execution.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/threat_modeling.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/vulnerability_management.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/AGENTS.MD +56 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/README.md +45 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/behavioral_guidelines/story_designer_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/examples/story_designer_task_flow.md +26 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/policies/story_designer_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/policies/story_designer_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer.md +39 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_deliverables.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/AGENTS.MD +56 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/README.md +45 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/behavioral_guidelines/story_novel_artist_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/examples/story_novel_artist_task_flow.md +26 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/policies/story_novel_artist_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/policies/story_novel_artist_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist.md +39 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_deliverables.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/AGENTS.MD +66 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/SKILLS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/behavioral_guidelines/data_engineer_behavior_overrides.md +6 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/policies/data_engineer_policy_overrides.md +6 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/profile_overrides.md +9 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/skills/data_engineer_skill_overrides.md +6 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/AGENTS.MD +145 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/SKILLS.MD +37 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/WORKFLOWS.MD +17 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/behavioral_guidelines/synaptic_finishing_developer_behavior_overrides.md +12 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/comment_finishing_examples.py +65 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/docstring_finishing_examples.py +126 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_component_finishing_examples.py +51 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_integration_finishing_examples.py +59 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_unit_finishing_examples.py +66 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/policies/synaptic_finishing_developer_policy_overrides.md +14 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/profile_overrides.md +17 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/comment_craft.md +51 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/docstring_craft.md +86 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/docstring_test_alignment.md +51 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/system_aware_docstrings.md +64 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/synaptic_finishing_developer_skill_overrides.md +11 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/component_tests.md +45 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/evidence_reporting.md +25 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/mocking.md +35 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/pytest_integration.md +32 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/pytest_unit.md +49 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/regression_tests.md +24 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/testing_overview.md +71 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/optimize_pytests_for_repo.md +272 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/polish_repo_documentation.md +247 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/AGENTS.MD +386 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/README.md +31 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/WORKFLOWS.MD +16 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/behavioral_guidelines/synaptic_behavior_overrides.md +17 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/anti_patterns.py +19 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/cleanup_patterns.py +22 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/docstrings.py +19 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/logging_patterns.py +11 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/protocols_and_abc.py +15 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_component_examples.py +15 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_integration_examples.py +17 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_unit_examples.py +13 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/policies/synaptic_policy_overrides.md +22 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/profile_overrides.md +27 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/attribute_aliasing_skill_benchmark.py +35 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/banned_patterns.md +110 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/cleanup_and_disposal.md +79 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/comments.md +39 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/docstrings.md +90 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/error_model.md +28 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/hot_path_attribute_aliasing.md +52 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/init_and_ownership.md +35 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/interfaces.md +47 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/logging.md +37 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/module_scope.md +38 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/refactor_limits.md +44 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/typing.md +52 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/synaptic_skill_overrides.md +24 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/evidence_reporting.md +35 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/mocking.md +31 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/pytest_integration.md +36 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/pytest_unit.md +42 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/regression_tests.md +26 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/testing_overview.md +196 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/workflows/synaptic_python_developer_onboarding.md +226 -0
- contextcompass_cli/_package/artifact_board.md +64 -0
- contextcompass_cli/_package/artifacts/IMPORTANT_CONSIDERATION.md +43 -0
- contextcompass_cli/_package/artifacts/README.md +41 -0
- contextcompass_cli/_package/attention_board.md +79 -0
- contextcompass_cli/_package/config/context_compass_config.yaml +101 -0
- contextcompass_cli/_package/context_management/README.md +21 -0
- contextcompass_cli/_package/context_management/artifacts/.gitkeep +1 -0
- contextcompass_cli/_package/context_management/context_artifact_template.md +42 -0
- contextcompass_cli/_package/context_management/context_board.md +27 -0
- contextcompass_cli/_package/examples/adr_example.md +29 -0
- contextcompass_cli/_package/examples/artifact_workflow.md +20 -0
- contextcompass_cli/_package/examples/continuity_fact_checker_task_flow.md +23 -0
- contextcompass_cli/_package/examples/design_task_flow.md +35 -0
- contextcompass_cli/_package/examples/developmental_editor_task_flow.md +22 -0
- contextcompass_cli/_package/examples/draft_writer_task_flow.md +23 -0
- contextcompass_cli/_package/examples/eng_task_flow.md +31 -0
- contextcompass_cli/_package/examples/example_architecture/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_architecture/src_architecture.md +136 -0
- contextcompass_cli/_package/examples/example_architecture/src_architecture_index.md +46 -0
- contextcompass_cli/_package/examples/example_architecture/tests_architecture.md +148 -0
- contextcompass_cli/_package/examples/example_architecture/tests_architecture_index.md +46 -0
- contextcompass_cli/_package/examples/example_completed/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_completed/2026-02-19_context_compass_release_overview_artifact.md +33 -0
- contextcompass_cli/_package/examples/example_components/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_components/src_components.md +169 -0
- contextcompass_cli/_package/examples/example_components/src_components_index.md +44 -0
- contextcompass_cli/_package/examples/example_components/tests_components.md +96 -0
- contextcompass_cli/_package/examples/example_components/tests_components_index.md +42 -0
- contextcompass_cli/_package/examples/example_epics/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_epics/2026-02-19_context_compass_release_readiness_example_pack_epic.md +130 -0
- contextcompass_cli/_package/examples/example_graph_details/README.md +131 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/__init__.py +4 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/core/interfaces.py +10 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/core/resource.py +15 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/pipeline/pipeline.py +20 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/pipeline/stage.py +11 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/storage/store.py +20 -0
- contextcompass_cli/_package/examples/example_graph_details/src_graph.md +192 -0
- contextcompass_cli/_package/examples/example_graph_details/src_graph_index.md +32 -0
- contextcompass_cli/_package/examples/example_stories/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_stories/2026-02-19_context_compass_release_readiness_examples_story.md +120 -0
- contextcompass_cli/_package/examples/example_tasks/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_tasks/2026-02-19_context_compass_release_readiness_pack_task.md +147 -0
- contextcompass_cli/_package/examples/line_copy_editor_task_flow.md +23 -0
- contextcompass_cli/_package/examples/platform_task_flow.md +26 -0
- contextcompass_cli/_package/examples/proofreader_task_flow.md +23 -0
- contextcompass_cli/_package/examples/qa_task_flow.md +26 -0
- contextcompass_cli/_package/examples/repo_overview.md +63 -0
- contextcompass_cli/_package/examples/researcher_task_flow.md +23 -0
- contextcompass_cli/_package/examples/security_review_flow.md +24 -0
- contextcompass_cli/_package/examples/story_designer_task_flow.md +23 -0
- contextcompass_cli/_package/examples/story_novel_artist_task_flow.md +22 -0
- contextcompass_cli/_package/mailbox_board.md +79 -0
- contextcompass_cli/_package/special_instructions/README.md +16 -0
- contextcompass_cli/_package/system_docs/.gitkeep +0 -0
- contextcompass_cli/_package/system_docs/patches/active/README.md +25 -0
- contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/architecture_patch.md +53 -0
- contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/code_description_patch_TEMPLATE_COMPONENT.md +39 -0
- contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/component_patch_TEMPLATE_COMPONENT.md +48 -0
- contextcompass_cli/_package/system_docs/system_docs_read_first.md +107 -0
- contextcompass_cli/_package/templates/epic_template.md +149 -0
- contextcompass_cli/_package/templates/story_template.md +131 -0
- contextcompass_cli/_package/templates/task_template.md +124 -0
- contextcompass_cli/_package/templates/workflow_advanced_template.md +111 -0
- contextcompass_cli/_package/templates/workflow_simple_template.md +65 -0
- contextcompass_cli/_package/tickets/README.md +24 -0
- contextcompass_cli/_package/tickets/epics/README.md +68 -0
- contextcompass_cli/_package/tickets/epics/archive/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/epics/backlog/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/epics/completed/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/stories/README.md +68 -0
- contextcompass_cli/_package/tickets/stories/archive/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/stories/backlog/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/stories/completed/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/tasks/README.md +67 -0
- contextcompass_cli/_package/tickets/tasks/archive/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/tasks/backlog/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/tasks/completed/.gitkeep +0 -0
- contextcompass_cli/_package/tools/build_llm_full.py +307 -0
- contextcompass_cli/_package/tools/cleanup_context_compass.py +488 -0
- contextcompass_cli/_package/tools/migrate_boards.py +218 -0
- contextcompass_cli/_package/tools/package_manifest.py +351 -0
- contextcompass_cli/_package/tools/system_documents/index_document.py +476 -0
- contextcompass_cli/_package/tools/system_documents/python/assemble_graph.py +387 -0
- contextcompass_cli/_package/tools/system_documents/python/extract_graph.py +626 -0
- contextcompass_cli/_package/tools/system_documents/python/graph_semantics_tickets.py +405 -0
- contextcompass_cli/_package/tools/system_documents/python/graph_walker.py +375 -0
- contextcompass_cli/_package/tools/system_documents/python/migrate_authored_graph.py +179 -0
- contextcompass_cli/_package/tools/update_context_compass.py +511 -0
- contextcompass_cli/_package/user_defined/README.md +49 -0
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# Story: <short, outcome-focused title>
|
|
4
|
+
|
|
5
|
+
## Metadata
|
|
6
|
+
- Story ID: STORY-YYYY-MM-DD-<slug>
|
|
7
|
+
- Epic: EPIC-YYYY-MM-DD-<slug>
|
|
8
|
+
- Status: draft | ready | in_progress | blocked | done
|
|
9
|
+
- Owner:
|
|
10
|
+
- Agent Name: <one or more assigned names, comma-separated>
|
|
11
|
+
- Priority: p0 | p1 | p2 | p3
|
|
12
|
+
- Created: YYYY-MM-DDTHH:MM:SSZ
|
|
13
|
+
- Updated: YYYY-MM-DDTHH:MM:SSZ
|
|
14
|
+
|
|
15
|
+
## User Narrative
|
|
16
|
+
As a <user/persona>, I want <capability>, so that <outcome>.
|
|
17
|
+
|
|
18
|
+
## Value / MRP Alignment
|
|
19
|
+
<Explain how this story strengthens the holistic core.>
|
|
20
|
+
|
|
21
|
+
## Ticket Contract
|
|
22
|
+
- ENTRY_GATE: <active board row and linked task/story prerequisites satisfied>
|
|
23
|
+
- EXECUTION_BOUNDARY: <story-level surfaces allowed; no unrelated expansion>
|
|
24
|
+
- DEPENDENCIES: <task set and prerequisite tickets/stories/epic milestones>
|
|
25
|
+
- EXIT_GATE: <acceptance + child-task state + board-sync requirements>
|
|
26
|
+
- FAILURE_ESCALATION: <when to raise DECISION_REQUEST/CONFLICT/BLOCKER>
|
|
27
|
+
|
|
28
|
+
## Requirements (Functional)
|
|
29
|
+
-
|
|
30
|
+
|
|
31
|
+
## Requirements (Non-Functional)
|
|
32
|
+
-
|
|
33
|
+
|
|
34
|
+
## Scope Boundaries
|
|
35
|
+
- In scope:
|
|
36
|
+
- Out of scope:
|
|
37
|
+
|
|
38
|
+
## State Transition Event
|
|
39
|
+
- from_state: draft | ready | in_progress | blocked | review
|
|
40
|
+
- to_state: ready | in_progress | blocked | review | done
|
|
41
|
+
- transition_reason: <why this transition is valid now>
|
|
42
|
+
|
|
43
|
+
## Dependencies / Related Work
|
|
44
|
+
-
|
|
45
|
+
|
|
46
|
+
## Tasks (Implementation Checklist)
|
|
47
|
+
- [ ] Task: <TASK-ID> - <short description>
|
|
48
|
+
- [ ] Task: <TASK-ID> - <short description>
|
|
49
|
+
- [ ] Enforce Ticket Microcycle across all linked tasks.
|
|
50
|
+
- [ ] Require meaningful-finding note updates during discovery/implementation.
|
|
51
|
+
|
|
52
|
+
## Acceptance Criteria
|
|
53
|
+
-
|
|
54
|
+
|
|
55
|
+
## Validation / Test Plan
|
|
56
|
+
-
|
|
57
|
+
|
|
58
|
+
## UX / API / Data Notes
|
|
59
|
+
-
|
|
60
|
+
|
|
61
|
+
## Risks / Mitigations
|
|
62
|
+
-
|
|
63
|
+
|
|
64
|
+
## Applicable Anti-Patterns
|
|
65
|
+
- [ ] No story-state transition without linked task-state evidence.
|
|
66
|
+
- [ ] No closure while required tasks remain active or un-routed.
|
|
67
|
+
- [ ] No cross-task synthesis claims without ticket-note evidence pointers.
|
|
68
|
+
|
|
69
|
+
## Open Questions
|
|
70
|
+
-
|
|
71
|
+
|
|
72
|
+
## Decision Log
|
|
73
|
+
-
|
|
74
|
+
|
|
75
|
+
## Artifact Links (Optional)
|
|
76
|
+
- ARTIFACTS_REQUIRED: true | false
|
|
77
|
+
- ARTIFACT_PATHS:
|
|
78
|
+
- <artifacts/YYYY-MM-DD_<slug>.<ext>>
|
|
79
|
+
- DISPOSITION: delete_on_close | retain_as_reference | promote_to_documentation
|
|
80
|
+
- CLEANUP_TRIGGER: <when artifact cleanup/retention decision is applied>
|
|
81
|
+
|
|
82
|
+
## Context Management
|
|
83
|
+
- CONTEXT_MANAGEMENT_REQUIRED: true | false
|
|
84
|
+
- CONTEXT_IDS:
|
|
85
|
+
- CTX-YYYY-MM-DD-<slug> | UNKNOWN
|
|
86
|
+
- CONTEXT_TOPICS:
|
|
87
|
+
- <topic or question> | UNKNOWN
|
|
88
|
+
- IF_UNKNOWN: UNKNOWN | ask user before implementation | none
|
|
89
|
+
|
|
90
|
+
## Notes
|
|
91
|
+
- DATETIME: YYYY-MM-DDTHH:MM:SSZ
|
|
92
|
+
TYPE:
|
|
93
|
+
FACT | UNKNOWN | HYPOTHESIS | DECISION | DECISION_REQUEST | PLAN |
|
|
94
|
+
STRATEGY_DISCUSSION | ASSUMPTION_CHALLENGE | CONFLICT | TRADEOFF |
|
|
95
|
+
BLOCKER | ALIGNMENT_CHECK | MEASURE | RISK | RAISE
|
|
96
|
+
CLAIM: <short finding>
|
|
97
|
+
EVIDENCE:
|
|
98
|
+
- <path:start_line-end_line>
|
|
99
|
+
- <path:start_line-end_line>
|
|
100
|
+
IMPACT: <why this matters>
|
|
101
|
+
NEXT: <one concrete next action>
|
|
102
|
+
REREAD: REQUIRED | HELPFUL
|
|
103
|
+
SCORE_0_TO_10: <0-10 compaction usefulness>
|
|
104
|
+
|
|
105
|
+
## Closure Confirmation
|
|
106
|
+
- [ ] Work walkthrough shared with user
|
|
107
|
+
- [ ] Acceptance criteria confirmed by user
|
|
108
|
+
- [ ] Applicable anti-pattern checks are clear or escalated with evidence.
|
|
109
|
+
|
|
110
|
+
## Noting Behavior
|
|
111
|
+
- Note focus: cross-task synthesis, dependency flow, and state-transition logic.
|
|
112
|
+
- Add notes when task routing changes, gate decisions are made, or risks shift.
|
|
113
|
+
- Reference child-task notes for evidence instead of duplicating tactical detail.
|
|
114
|
+
- Keep notes append-only and preserve UNKNOWN-first promotion discipline.
|
|
115
|
+
|
|
116
|
+
## Context / Handoff Summary
|
|
117
|
+
<Succinct summary of current state, key decisions, and next steps for future context.>
|
|
118
|
+
|
|
119
|
+
## Project-Specific Additions
|
|
120
|
+
<!-- BEGIN USER-DEFINED: project_fields -->
|
|
121
|
+
<!-- END USER-DEFINED: project_fields -->
|
|
122
|
+
|
|
123
|
+
<!--
|
|
124
|
+
Anything this project needs on every ticket of this kind goes in the region
|
|
125
|
+
above: extra fields, a compliance checklist, a link to a local convention.
|
|
126
|
+
|
|
127
|
+
The region is yours. An upgrade replaces every other line of this template with
|
|
128
|
+
the new version's text and carries this region across untouched, so a local
|
|
129
|
+
addition here is not a divergence you re-resolve on every upgrade - which is
|
|
130
|
+
what editing the rest of the template would cost you.
|
|
131
|
+
-->
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# Task: <short, action-focused title>
|
|
4
|
+
|
|
5
|
+
## Metadata
|
|
6
|
+
- Task ID: TASK-YYYY-MM-DD-<slug>
|
|
7
|
+
- Story: STORY-YYYY-MM-DD-<slug>
|
|
8
|
+
- Status: draft | ready | in_progress | blocked | done
|
|
9
|
+
- Owner:
|
|
10
|
+
- Agent Name: <one or more assigned names, comma-separated>
|
|
11
|
+
- Priority: p0 | p1 | p2 | p3
|
|
12
|
+
- Created: YYYY-MM-DDTHH:MM:SSZ
|
|
13
|
+
- Updated: YYYY-MM-DDTHH:MM:SSZ
|
|
14
|
+
|
|
15
|
+
## Objective
|
|
16
|
+
<Define the smallest meaningful outcome this task delivers.>
|
|
17
|
+
|
|
18
|
+
## Ticket Contract
|
|
19
|
+
- ENTRY_GATE: <active board row and latest note requirements before work starts>
|
|
20
|
+
- EXECUTION_BOUNDARY: <files/symbols/surfaces allowed in this task>
|
|
21
|
+
- DEPENDENCIES: <upstream/downstream tickets or docs this task depends on>
|
|
22
|
+
- EXIT_GATE: <conditions required before status can move to review/done>
|
|
23
|
+
- FAILURE_ESCALATION: <when to record DECISION_REQUEST/CONFLICT/BLOCKER>
|
|
24
|
+
|
|
25
|
+
## Scope Boundaries
|
|
26
|
+
- In scope:
|
|
27
|
+
- Out of scope:
|
|
28
|
+
|
|
29
|
+
## State Transition Event
|
|
30
|
+
- from_state: draft | ready | in_progress | blocked | review
|
|
31
|
+
- to_state: ready | in_progress | blocked | review | done
|
|
32
|
+
- transition_reason: <why this transition is valid now>
|
|
33
|
+
|
|
34
|
+
## Steps / Checklist
|
|
35
|
+
- [ ]
|
|
36
|
+
- [ ]
|
|
37
|
+
- [ ] Run Ticket Microcycle during execution:
|
|
38
|
+
`Investigate -> Document -> Strategy/Plan -> Document -> Implement ->
|
|
39
|
+
Document -> Validate -> Document`.
|
|
40
|
+
- [ ] Document each meaningful finding immediately in `## Notes` before further investigation.
|
|
41
|
+
|
|
42
|
+
## Deliverables
|
|
43
|
+
-
|
|
44
|
+
|
|
45
|
+
## Files / Paths Impacted
|
|
46
|
+
-
|
|
47
|
+
|
|
48
|
+
## Validation
|
|
49
|
+
- Not run.
|
|
50
|
+
- Recommended commands:
|
|
51
|
+
-
|
|
52
|
+
|
|
53
|
+
## Risks / Rollback Notes
|
|
54
|
+
-
|
|
55
|
+
|
|
56
|
+
## Applicable Anti-Patterns
|
|
57
|
+
- [ ] No status transition without evidence-backed transition reason.
|
|
58
|
+
- [ ] No implementation/validation from `UNKNOWN` or `HYPOTHESIS`.
|
|
59
|
+
- [ ] No closure without acceptance confirmation and board-sync completion.
|
|
60
|
+
|
|
61
|
+
## Done Checklist
|
|
62
|
+
- [ ] Steps complete and checked off
|
|
63
|
+
- [ ] Deliverables produced and linked
|
|
64
|
+
- [ ] Documentation updated (if needed)
|
|
65
|
+
- [ ] Validation status recorded
|
|
66
|
+
- [ ] Unknown-first discipline followed (`UNKNOWN` promoted to `FACT` only with evidence)
|
|
67
|
+
- [ ] Notes quality maintained (`SCORE_0_TO_10` >=
|
|
68
|
+
`workflow.ticket_microcycle.minimum_note_score`)
|
|
69
|
+
- [ ] Applicable anti-pattern checks are clear or escalated with evidence.
|
|
70
|
+
- [ ] Acceptance criteria reviewed with user and confirmed
|
|
71
|
+
- [ ] Board sync completed for successor routing or closure anchor update.
|
|
72
|
+
|
|
73
|
+
## Artifact Links (Optional)
|
|
74
|
+
- ARTIFACTS_REQUIRED: true | false
|
|
75
|
+
- ARTIFACT_PATHS:
|
|
76
|
+
- <artifacts/YYYY-MM-DD_<slug>.<ext>>
|
|
77
|
+
- DISPOSITION: delete_on_close | retain_as_reference | promote_to_documentation
|
|
78
|
+
- CLEANUP_TRIGGER: <when artifact cleanup/retention decision is applied>
|
|
79
|
+
|
|
80
|
+
## Context Management
|
|
81
|
+
- CONTEXT_MANAGEMENT_REQUIRED: true | false
|
|
82
|
+
- CONTEXT_IDS:
|
|
83
|
+
- CTX-YYYY-MM-DD-<slug> | UNKNOWN
|
|
84
|
+
- CONTEXT_TOPICS:
|
|
85
|
+
- <topic or question> | UNKNOWN
|
|
86
|
+
- IF_UNKNOWN: UNKNOWN | ask user before implementation | none
|
|
87
|
+
|
|
88
|
+
## Noting Behavior
|
|
89
|
+
- Note focus: tactical findings, concrete impacts, and single-step continuation.
|
|
90
|
+
- Add a `## Notes` entry after each meaningful finding before continuing.
|
|
91
|
+
- Keep notes append-only; correct history only for factual errors.
|
|
92
|
+
- Promote `UNKNOWN` to `FACT` only with direct evidence pointers.
|
|
93
|
+
|
|
94
|
+
## Notes
|
|
95
|
+
- DATETIME: YYYY-MM-DDTHH:MM:SSZ
|
|
96
|
+
TYPE:
|
|
97
|
+
FACT | UNKNOWN | HYPOTHESIS | DECISION | DECISION_REQUEST | PLAN |
|
|
98
|
+
STRATEGY_DISCUSSION | ASSUMPTION_CHALLENGE | CONFLICT | TRADEOFF |
|
|
99
|
+
BLOCKER | ALIGNMENT_CHECK | MEASURE | RISK | RAISE
|
|
100
|
+
CLAIM: <short finding>
|
|
101
|
+
EVIDENCE:
|
|
102
|
+
- <path:start_line-end_line>
|
|
103
|
+
- <path:start_line-end_line>
|
|
104
|
+
IMPACT: <why this matters>
|
|
105
|
+
NEXT: <one concrete next action>
|
|
106
|
+
REREAD: REQUIRED | HELPFUL
|
|
107
|
+
SCORE_0_TO_10: <0-10 compaction usefulness>
|
|
108
|
+
|
|
109
|
+
## Context / Handoff Summary
|
|
110
|
+
<Succinct summary of current state, key decisions, and next steps for future context.>
|
|
111
|
+
|
|
112
|
+
## Project-Specific Additions
|
|
113
|
+
<!-- BEGIN USER-DEFINED: project_fields -->
|
|
114
|
+
<!-- END USER-DEFINED: project_fields -->
|
|
115
|
+
|
|
116
|
+
<!--
|
|
117
|
+
Anything this project needs on every ticket of this kind goes in the region
|
|
118
|
+
above: extra fields, a compliance checklist, a link to a local convention.
|
|
119
|
+
|
|
120
|
+
The region is yours. An upgrade replaces every other line of this template with
|
|
121
|
+
the new version's text and carries this region across untouched, so a local
|
|
122
|
+
addition here is not a divergence you re-resolve on every upgrade - which is
|
|
123
|
+
what editing the rest of the template would cost you.
|
|
124
|
+
-->
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
# Workflow: <short outcome-focused title>
|
|
2
|
+
|
|
3
|
+
## Metadata
|
|
4
|
+
- Workflow ID: WF-<slug>
|
|
5
|
+
- Status: draft | ready | active | deprecated
|
|
6
|
+
- Owner:
|
|
7
|
+
- Allowed Roles:
|
|
8
|
+
- Default Roles:
|
|
9
|
+
- Trigger:
|
|
10
|
+
- Created: YYYY-MM-DDTHH:MM:SSZ
|
|
11
|
+
- Updated: YYYY-MM-DDTHH:MM:SSZ
|
|
12
|
+
|
|
13
|
+
## Purpose
|
|
14
|
+
<What macro behavior this workflow provides.>
|
|
15
|
+
|
|
16
|
+
## Use When
|
|
17
|
+
- <valid trigger 1>
|
|
18
|
+
- <valid trigger 2>
|
|
19
|
+
|
|
20
|
+
## Do Not Use When
|
|
21
|
+
- <invalid trigger 1>
|
|
22
|
+
- <invalid trigger 2>
|
|
23
|
+
|
|
24
|
+
## Inputs
|
|
25
|
+
- Required:
|
|
26
|
+
- Optional:
|
|
27
|
+
|
|
28
|
+
## Outputs
|
|
29
|
+
- Expected artifacts:
|
|
30
|
+
- Expected ticket state:
|
|
31
|
+
- Expected board state:
|
|
32
|
+
|
|
33
|
+
## Required Reads
|
|
34
|
+
- <doc path>
|
|
35
|
+
- <doc path>
|
|
36
|
+
|
|
37
|
+
## Required Skills
|
|
38
|
+
- <skill path>
|
|
39
|
+
- <skill path>
|
|
40
|
+
|
|
41
|
+
## Preconditions / Gates
|
|
42
|
+
- <gate 1>
|
|
43
|
+
- <gate 2>
|
|
44
|
+
|
|
45
|
+
## Phase Sequence
|
|
46
|
+
1. Intake
|
|
47
|
+
- objective:
|
|
48
|
+
- required actions:
|
|
49
|
+
- stop conditions:
|
|
50
|
+
|
|
51
|
+
2. Investigation
|
|
52
|
+
- objective:
|
|
53
|
+
- required actions:
|
|
54
|
+
- required note or artifact updates:
|
|
55
|
+
|
|
56
|
+
3. Strategy
|
|
57
|
+
- objective:
|
|
58
|
+
- decision points:
|
|
59
|
+
|
|
60
|
+
4. Implementation
|
|
61
|
+
- objective:
|
|
62
|
+
- scope controls:
|
|
63
|
+
|
|
64
|
+
5. Validation
|
|
65
|
+
- objective:
|
|
66
|
+
- required checks:
|
|
67
|
+
|
|
68
|
+
6. Handoff / Closure
|
|
69
|
+
- objective:
|
|
70
|
+
- required board or ticket sync:
|
|
71
|
+
|
|
72
|
+
## Ticket Behavior
|
|
73
|
+
- Required ticket types:
|
|
74
|
+
- Required metadata:
|
|
75
|
+
- Required note cadence:
|
|
76
|
+
- Required artifact links:
|
|
77
|
+
|
|
78
|
+
## Attention Board Behavior
|
|
79
|
+
- Required row fields:
|
|
80
|
+
- Mode transitions:
|
|
81
|
+
- Exit signal rules:
|
|
82
|
+
|
|
83
|
+
## Escalation Rules
|
|
84
|
+
- <when to stop>
|
|
85
|
+
- <when to raise DECISION_REQUEST>
|
|
86
|
+
- <when to raise BLOCKER>
|
|
87
|
+
|
|
88
|
+
## Success Criteria
|
|
89
|
+
- <condition 1>
|
|
90
|
+
- <condition 2>
|
|
91
|
+
|
|
92
|
+
## Anti-Patterns
|
|
93
|
+
- <bad behavior 1>
|
|
94
|
+
- <bad behavior 2>
|
|
95
|
+
|
|
96
|
+
## Context / Handoff Summary
|
|
97
|
+
<What a future agent must know to resume safely.>
|
|
98
|
+
|
|
99
|
+
## Project-Specific Additions
|
|
100
|
+
<!-- BEGIN USER-DEFINED: project_fields -->
|
|
101
|
+
<!-- END USER-DEFINED: project_fields -->
|
|
102
|
+
|
|
103
|
+
<!--
|
|
104
|
+
Anything this project needs on every ticket of this kind goes in the region
|
|
105
|
+
above: extra fields, a compliance checklist, a link to a local convention.
|
|
106
|
+
|
|
107
|
+
The region is yours. An upgrade replaces every other line of this template with
|
|
108
|
+
the new version's text and carries this region across untouched, so a local
|
|
109
|
+
addition here is not a divergence you re-resolve on every upgrade - which is
|
|
110
|
+
what editing the rest of the template would cost you.
|
|
111
|
+
-->
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# Workflow: <short outcome-focused title>
|
|
2
|
+
|
|
3
|
+
## Metadata
|
|
4
|
+
- Workflow ID: WF-<slug>
|
|
5
|
+
- Status: draft | ready | active | deprecated
|
|
6
|
+
- Owner:
|
|
7
|
+
- Created: YYYY-MM-DDTHH:MM:SSZ
|
|
8
|
+
- Updated: YYYY-MM-DDTHH:MM:SSZ
|
|
9
|
+
|
|
10
|
+
## Purpose
|
|
11
|
+
<What macro behavior this workflow provides.>
|
|
12
|
+
|
|
13
|
+
## Required Reads
|
|
14
|
+
- <doc path>
|
|
15
|
+
- <doc path>
|
|
16
|
+
|
|
17
|
+
## Required Skills
|
|
18
|
+
- <skill path>
|
|
19
|
+
- <skill path>
|
|
20
|
+
|
|
21
|
+
## Phase Sequence
|
|
22
|
+
1. Intake
|
|
23
|
+
- objective:
|
|
24
|
+
- required actions:
|
|
25
|
+
- stop conditions:
|
|
26
|
+
|
|
27
|
+
2. Investigation
|
|
28
|
+
- objective:
|
|
29
|
+
- required actions:
|
|
30
|
+
- required note or artifact updates:
|
|
31
|
+
|
|
32
|
+
3. Strategy
|
|
33
|
+
- objective:
|
|
34
|
+
- decision points:
|
|
35
|
+
|
|
36
|
+
4. Implementation
|
|
37
|
+
- objective:
|
|
38
|
+
- scope controls:
|
|
39
|
+
|
|
40
|
+
5. Validation
|
|
41
|
+
- objective:
|
|
42
|
+
- required checks:
|
|
43
|
+
|
|
44
|
+
6. Handoff / Closure
|
|
45
|
+
- objective:
|
|
46
|
+
- required board or ticket sync:
|
|
47
|
+
|
|
48
|
+
## Attention Board Behavior
|
|
49
|
+
- Required row fields:
|
|
50
|
+
- Mode transitions:
|
|
51
|
+
- Exit signal rules:
|
|
52
|
+
|
|
53
|
+
## Project-Specific Additions
|
|
54
|
+
<!-- BEGIN USER-DEFINED: project_fields -->
|
|
55
|
+
<!-- END USER-DEFINED: project_fields -->
|
|
56
|
+
|
|
57
|
+
<!--
|
|
58
|
+
Anything this project needs on every ticket of this kind goes in the region
|
|
59
|
+
above: extra fields, a compliance checklist, a link to a local convention.
|
|
60
|
+
|
|
61
|
+
The region is yours. An upgrade replaces every other line of this template with
|
|
62
|
+
the new version's text and carries this region across untouched, so a local
|
|
63
|
+
addition here is not a divergence you re-resolve on every upgrade - which is
|
|
64
|
+
what editing the rest of the template would cost you.
|
|
65
|
+
-->
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# Tickets
|
|
4
|
+
|
|
5
|
+
Purpose
|
|
6
|
+
- User-facing index for ticket storage.
|
|
7
|
+
- Keep ticket lanes grouped in one root for easier navigation.
|
|
8
|
+
|
|
9
|
+
Structure
|
|
10
|
+
- `tickets/epics/`: active and backlog epic tickets.
|
|
11
|
+
- `tickets/stories/`: active and backlog story tickets.
|
|
12
|
+
- `tickets/tasks/`: active and backlog task tickets.
|
|
13
|
+
- `tickets/*/completed/`: completed tickets per lane.
|
|
14
|
+
|
|
15
|
+
Backlog locations
|
|
16
|
+
- `tickets/epics/backlog/`
|
|
17
|
+
- `tickets/stories/backlog/`
|
|
18
|
+
- `tickets/tasks/backlog/`
|
|
19
|
+
|
|
20
|
+
Notes
|
|
21
|
+
- Active routing still comes from `attention_board.md`.
|
|
22
|
+
- Durable execution memory still lives in each active ticket `## Notes`.
|
|
23
|
+
|
|
24
|
+
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# Epics
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
Epics capture multi-story outcomes that define durable, MRP-aligned changes. They are the
|
|
7
|
+
top-level planning unit and must be rich enough to survive context compaction.
|
|
8
|
+
|
|
9
|
+
## MRP First (Required)
|
|
10
|
+
- Every epic must describe the holistic core being built and why it is the right foundation.
|
|
11
|
+
- MRP means "reasonable," not "minimal." Avoid scope that forces a rewrite later.
|
|
12
|
+
- MVP framing is disallowed. If there is doubt, default to MRP and durability.
|
|
13
|
+
- Use MLP only when explicitly tied to UI/UX polish after the core is solid.
|
|
14
|
+
|
|
15
|
+
## What Belongs Here
|
|
16
|
+
- Multi-story outcomes that change core system behavior or architecture.
|
|
17
|
+
- Cross-cutting initiatives that require multiple stories and tasks.
|
|
18
|
+
- Policy or documentation programs that affect how we work or ship.
|
|
19
|
+
|
|
20
|
+
## File Naming
|
|
21
|
+
Use date-first, descriptive names:
|
|
22
|
+
- `YYYY-MM-DD_<slug>_epic.md`
|
|
23
|
+
|
|
24
|
+
Backlog location:
|
|
25
|
+
- park non-active epics in `context_compass/tickets/epics/backlog/`.
|
|
26
|
+
|
|
27
|
+
When completed, move to `context_compass/tickets/epics/completed/` and rename to:
|
|
28
|
+
- `YYYY-MM-DD_<slug>_epic_completed.md`
|
|
29
|
+
|
|
30
|
+
## How To Create An Epic (Deep, Not Minimal)
|
|
31
|
+
1. Copy `context_compass/templates/epic_template.md`.
|
|
32
|
+
2. Fill Metadata and keep `Status` and `Updated` current.
|
|
33
|
+
3. Document Problem / Opportunity with concrete evidence and context.
|
|
34
|
+
4. Write MRP Alignment as a durable, coherent core (not a quick experiment).
|
|
35
|
+
5. Fill `Ticket Contract` (`ENTRY_GATE`, `EXECUTION_BOUNDARY`,
|
|
36
|
+
`DEPENDENCIES`, `EXIT_GATE`, `FAILURE_ESCALATION`).
|
|
37
|
+
6. Define Goals, Non-Goals, Scope Boundaries, and Requirements.
|
|
38
|
+
7. Record a `State Transition Event` for status changes.
|
|
39
|
+
8. Add Success Metrics and Acceptance Criteria that are observable.
|
|
40
|
+
9. Add Milestones with clear success criteria (`- [ ]` checkboxes required).
|
|
41
|
+
10. List Stories required to complete the epic, each with an ID.
|
|
42
|
+
11. Add Epic-level Tasks like "Complete story <STORY-ID>" to make progress explicit.
|
|
43
|
+
12. Fill `Applicable Anti-Patterns` with program-level checks (not full catalog).
|
|
44
|
+
13. Keep `Noting Behavior` focused on cross-story tradeoffs and sequencing.
|
|
45
|
+
14. Add `Artifact Links (Optional)` only when the epic tracks concrete artifacts.
|
|
46
|
+
15. Record artifact disposition (`delete_on_close`, `retain_as_reference`, or
|
|
47
|
+
`promote_to_documentation`) for linked artifacts.
|
|
48
|
+
16. Record Risks / Mitigations, Validation plan, and Decision Log.
|
|
49
|
+
17. Keep the Context / Handoff Summary current and specific (context is gold).
|
|
50
|
+
|
|
51
|
+
## Depth Standard (No Handwaving)
|
|
52
|
+
- Use concrete evidence and references (docs, code paths, diagrams).
|
|
53
|
+
- Make assumptions explicit and list open questions.
|
|
54
|
+
- Write so a future reader can resume without hidden knowledge.
|
|
55
|
+
- Keep notes program-level; reference story/task notes for tactical evidence.
|
|
56
|
+
|
|
57
|
+
## Completion Rules
|
|
58
|
+
- Add completion header at the top of the file (see `context_compass/agent_onboarding/default/general/skills/workflow.md`).
|
|
59
|
+
- Move the file to `context_compass/tickets/epics/completed/` with the `_completed` suffix.
|
|
60
|
+
|
|
61
|
+
## References
|
|
62
|
+
- `context_compass/SKILLS.MD` (deep descriptive model and naming rules)
|
|
63
|
+
- `context_compass/agent_onboarding/default/general/skills/workflow.md` (ticket lifecycle and completion format)
|
|
64
|
+
- `context_compass/templates/epic_template.md`
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# Stories
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
Stories define a user- or system-facing slice of value within an epic. They translate an
|
|
7
|
+
epic outcome into a coherent, testable unit of delivery that strengthens the MRP core.
|
|
8
|
+
|
|
9
|
+
## MRP First (Required)
|
|
10
|
+
- Every story must explain how it hardens or extends the core system.
|
|
11
|
+
- MRP means "reasonable," not "minimal." Avoid scope that forces a rewrite later.
|
|
12
|
+
- MVP framing is disallowed. Do not trade durability for speed.
|
|
13
|
+
- MLP is allowed only when the story is explicitly about UI/UX polish.
|
|
14
|
+
|
|
15
|
+
## What Belongs Here
|
|
16
|
+
- A single, cohesive slice of value inside one epic.
|
|
17
|
+
- A scope that can be completed by a small set of tasks with clear deliverables.
|
|
18
|
+
|
|
19
|
+
## File Naming
|
|
20
|
+
Use date-first, descriptive names:
|
|
21
|
+
- `YYYY-MM-DD_<slug>_story.md`
|
|
22
|
+
|
|
23
|
+
Backlog location:
|
|
24
|
+
- park non-active stories in `context_compass/tickets/stories/backlog/`.
|
|
25
|
+
|
|
26
|
+
When completed, move to `context_compass/tickets/stories/completed/` and rename to:
|
|
27
|
+
- `YYYY-MM-DD_<slug>_story_completed.md`
|
|
28
|
+
|
|
29
|
+
## How To Create A Story (Deep, Not Minimal)
|
|
30
|
+
1. Copy `context_compass/templates/story_template.md`.
|
|
31
|
+
2. Link the story to its epic in Metadata.
|
|
32
|
+
3. Write a precise User Narrative with a concrete outcome.
|
|
33
|
+
4. Explain Value / MRP Alignment with system-level impact.
|
|
34
|
+
5. Fill `Ticket Contract` (`ENTRY_GATE`, `EXECUTION_BOUNDARY`,
|
|
35
|
+
`DEPENDENCIES`, `EXIT_GATE`, `FAILURE_ESCALATION`).
|
|
36
|
+
6. Define Functional + Non-Functional requirements.
|
|
37
|
+
7. Set Scope Boundaries and list Dependencies.
|
|
38
|
+
8. Record a `State Transition Event` for status changes.
|
|
39
|
+
9. Create a task checklist with explicit task IDs.
|
|
40
|
+
10. Define Acceptance Criteria that are observable and testable.
|
|
41
|
+
11. Add Validation / Test Plan and any UX/API/Data notes.
|
|
42
|
+
12. Fill `Applicable Anti-Patterns` with lane-specific checks (not full catalog).
|
|
43
|
+
13. Keep `Noting Behavior` aligned to cross-task synthesis notes.
|
|
44
|
+
14. Add `Artifact Links (Optional)` when story work produces supporting
|
|
45
|
+
artifacts.
|
|
46
|
+
15. Record artifact disposition (`delete_on_close`, `retain_as_reference`, or
|
|
47
|
+
`promote_to_documentation`) for linked artifacts.
|
|
48
|
+
16. Record Risks / Mitigations, Decision Log, and keep Context / Handoff
|
|
49
|
+
Summary current.
|
|
50
|
+
|
|
51
|
+
## Depth Standard (No Handwaving)
|
|
52
|
+
- Cite relevant code paths, docs, or diagrams.
|
|
53
|
+
- Make uncertainties and open questions explicit.
|
|
54
|
+
- Write so a future reader can execute without additional context.
|
|
55
|
+
- Keep notes synthesis-focused (task outcomes, dependency shifts, gate changes).
|
|
56
|
+
|
|
57
|
+
## Completion Rules
|
|
58
|
+
- Add completion header at the top of the file (see `context_compass/agent_onboarding/default/general/skills/workflow.md`).
|
|
59
|
+
- Move the file to `context_compass/tickets/stories/completed/` with the `_completed` suffix.
|
|
60
|
+
|
|
61
|
+
## References
|
|
62
|
+
- `context_compass/SKILLS.MD` (deep descriptive model and naming rules)
|
|
63
|
+
- `context_compass/agent_onboarding/default/general/skills/workflow.md` (ticket lifecycle and completion format)
|
|
64
|
+
- `context_compass/templates/story_template.md`
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
# Tasks
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
Tasks are the smallest actionable units that produce concrete deliverables. They must be
|
|
7
|
+
precise, testable, and aligned with the MRP-first approach.
|
|
8
|
+
|
|
9
|
+
## MRP First (Required)
|
|
10
|
+
- Every task must contribute to a coherent, durable outcome.
|
|
11
|
+
- MRP means "reasonable," not "minimal." Avoid scope that forces a rewrite later.
|
|
12
|
+
- MVP shortcuts are disallowed. The task should not create debt that must be rewritten.
|
|
13
|
+
- Use MLP only when a task is explicitly about UI/UX polish after core stability.
|
|
14
|
+
|
|
15
|
+
## What Belongs Here
|
|
16
|
+
- A single, concrete unit of work with clear scope and deliverables.
|
|
17
|
+
- Work that can be validated and completed within a focused effort window.
|
|
18
|
+
|
|
19
|
+
## File Naming
|
|
20
|
+
Use date-first, descriptive names:
|
|
21
|
+
- `YYYY-MM-DD_<slug>_task.md`
|
|
22
|
+
|
|
23
|
+
Backlog location:
|
|
24
|
+
- park non-active tasks in `context_compass/tickets/tasks/backlog/`.
|
|
25
|
+
|
|
26
|
+
When completed, move to `context_compass/tickets/tasks/completed/` and rename to:
|
|
27
|
+
- `YYYY-MM-DD_<slug>_task_completed.md`
|
|
28
|
+
|
|
29
|
+
## How To Create A Task (Deep, Not Minimal)
|
|
30
|
+
1. Copy `context_compass/templates/task_template.md`.
|
|
31
|
+
2. Link the task to its story in Metadata.
|
|
32
|
+
3. Write a concrete Objective that defines the smallest meaningful outcome.
|
|
33
|
+
4. Fill `Ticket Contract` (`ENTRY_GATE`, `EXECUTION_BOUNDARY`,
|
|
34
|
+
`DEPENDENCIES`, `EXIT_GATE`, `FAILURE_ESCALATION`).
|
|
35
|
+
5. Define Scope Boundaries (in scope / out of scope) to prevent creep.
|
|
36
|
+
6. Record a `State Transition Event` for status changes.
|
|
37
|
+
7. List Steps / Checklist with clear, ordered actions.
|
|
38
|
+
8. Define Deliverables and Files / Paths Impacted.
|
|
39
|
+
9. Record Validation status and recommended commands (or "Not run").
|
|
40
|
+
10. Capture Risks / Rollback Notes if relevant.
|
|
41
|
+
11. Fill `Applicable Anti-Patterns` with lane-specific checks (do not paste the
|
|
42
|
+
full catalog).
|
|
43
|
+
12. Keep `Noting Behavior` aligned to tactical task-level notes and update
|
|
44
|
+
`## Notes` on each meaningful finding.
|
|
45
|
+
13. Add `Artifact Links (Optional)` when the task creates supporting artifacts.
|
|
46
|
+
14. Record artifact disposition (`delete_on_close`, `retain_as_reference`, or
|
|
47
|
+
`promote_to_documentation`) and closure trigger for each linked artifact.
|
|
48
|
+
15. Complete the Done Checklist and keep Context / Handoff Summary current.
|
|
49
|
+
|
|
50
|
+
## Depth Standard (No Handwaving)
|
|
51
|
+
- Be explicit about what will change and why.
|
|
52
|
+
- Reference relevant files, docs, or diagrams.
|
|
53
|
+
- Record open questions or blockers immediately.
|
|
54
|
+
- Keep notes tactical: concrete finding -> impact -> one-step next action.
|
|
55
|
+
- Keep anti-pattern enforcement lightweight: lane-specific checklist only.
|
|
56
|
+
|
|
57
|
+
## Completion Rules
|
|
58
|
+
- Add completion header at the top of the file (see `context_compass/agent_onboarding/default/general/skills/workflow.md`).
|
|
59
|
+
- Move the file to `context_compass/tickets/tasks/completed/` with the `_completed` suffix.
|
|
60
|
+
|
|
61
|
+
## References
|
|
62
|
+
- `context_compass/SKILLS.MD` (deep descriptive model and naming rules)
|
|
63
|
+
- `context_compass/agent_onboarding/default/general/skills/workflow.md` (ticket lifecycle and completion format)
|
|
64
|
+
- `context_compass/templates/task_template.md`
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
|
|
File without changes
|
|
File without changes
|
|
File without changes
|