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.
Files changed (452) hide show
  1. contextcompass-2.15.0.dist-info/METADATA +673 -0
  2. contextcompass-2.15.0.dist-info/RECORD +452 -0
  3. contextcompass-2.15.0.dist-info/WHEEL +4 -0
  4. contextcompass-2.15.0.dist-info/entry_points.txt +2 -0
  5. contextcompass-2.15.0.dist-info/licenses/LICENSE +21 -0
  6. contextcompass_cli/__init__.py +74 -0
  7. contextcompass_cli/__main__.py +195 -0
  8. contextcompass_cli/_package/AGENTS.MD +310 -0
  9. contextcompass_cli/_package/CONTEXT_COMPACTION.md +110 -0
  10. contextcompass_cli/_package/MANIFEST.md +485 -0
  11. contextcompass_cli/_package/PROFILE_CLASS_CREATION_GUIDE.md +426 -0
  12. contextcompass_cli/_package/README.md +266 -0
  13. contextcompass_cli/_package/SKILLS.MD +144 -0
  14. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/AGENTS.MD +54 -0
  15. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/README.md +43 -0
  16. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/SKILLS.MD +44 -0
  17. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/WORKFLOWS.MD +15 -0
  18. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/behavioral_guidelines/continuity_fact_checker_workflow.md +23 -0
  19. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/examples/continuity_fact_checker_task_flow.md +24 -0
  20. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/policies/continuity_fact_checker_handoff_policy.md +20 -0
  21. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/policies/continuity_fact_checker_quality_policy.md +22 -0
  22. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker.md +37 -0
  23. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_advanced_context.md +17 -0
  24. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_deliverables.md +26 -0
  25. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_execution.md +23 -0
  26. contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/workflows/README.md +8 -0
  27. contextcompass_cli/_package/agent_onboarding/default/design_engineer/AGENTS.MD +85 -0
  28. contextcompass_cli/_package/agent_onboarding/default/design_engineer/README.md +62 -0
  29. contextcompass_cli/_package/agent_onboarding/default/design_engineer/SKILLS.MD +74 -0
  30. contextcompass_cli/_package/agent_onboarding/default/design_engineer/WORKFLOWS.MD +15 -0
  31. contextcompass_cli/_package/agent_onboarding/default/design_engineer/behavioral_guidelines/design_engineer_workflow.md +25 -0
  32. contextcompass_cli/_package/agent_onboarding/default/design_engineer/behavioral_guidelines/design_validation_and_handoff.md +25 -0
  33. contextcompass_cli/_package/agent_onboarding/default/design_engineer/examples/adr_example.md +40 -0
  34. contextcompass_cli/_package/agent_onboarding/default/design_engineer/examples/design_task_flow.md +33 -0
  35. contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/decision_record_policy.md +23 -0
  36. contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/design_quality_policy.md +30 -0
  37. contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/design_review_policy.md +22 -0
  38. contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/system_document_quality_rubric.md +236 -0
  39. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/adr_and_decision_hygiene.md +38 -0
  40. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/api_and_interface_design.md +36 -0
  41. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_contexts.md +40 -0
  42. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_patch_contracts.md +43 -0
  43. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_tradeoffs.md +33 -0
  44. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/code_description_patch_contracts.md +46 -0
  45. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/component_patch_contracts.md +41 -0
  46. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/data_modeling.md +34 -0
  47. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/decomposition_and_boundaries.md +42 -0
  48. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/design_engineer_execution.md +65 -0
  49. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/design_review_protocol.md +34 -0
  50. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/nonfunctional_requirements.md +34 -0
  51. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/patch_framework_design.md +79 -0
  52. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/requirements_to_architecture.md +39 -0
  53. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/src_architecture_instructions.md +347 -0
  54. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/src_components_instructions.md +405 -0
  55. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/system_design_method.md +45 -0
  56. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/tests_architecture_instructions.md +375 -0
  57. contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/tests_components_instructions.md +406 -0
  58. contextcompass_cli/_package/agent_onboarding/default/design_engineer/workflows/README.md +8 -0
  59. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/AGENTS.MD +53 -0
  60. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/README.md +42 -0
  61. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/SKILLS.MD +44 -0
  62. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/WORKFLOWS.MD +15 -0
  63. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/behavioral_guidelines/developmental_editor_workflow.md +23 -0
  64. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/examples/developmental_editor_task_flow.md +23 -0
  65. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/policies/developmental_editor_handoff_policy.md +20 -0
  66. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/policies/developmental_editor_quality_policy.md +22 -0
  67. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor.md +36 -0
  68. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_advanced_context.md +17 -0
  69. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_deliverables.md +25 -0
  70. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_execution.md +23 -0
  71. contextcompass_cli/_package/agent_onboarding/default/developmental_editor/workflows/README.md +8 -0
  72. contextcompass_cli/_package/agent_onboarding/default/draft_writer/AGENTS.MD +54 -0
  73. contextcompass_cli/_package/agent_onboarding/default/draft_writer/README.md +43 -0
  74. contextcompass_cli/_package/agent_onboarding/default/draft_writer/SKILLS.MD +44 -0
  75. contextcompass_cli/_package/agent_onboarding/default/draft_writer/WORKFLOWS.MD +15 -0
  76. contextcompass_cli/_package/agent_onboarding/default/draft_writer/behavioral_guidelines/draft_writer_workflow.md +23 -0
  77. contextcompass_cli/_package/agent_onboarding/default/draft_writer/examples/draft_writer_task_flow.md +24 -0
  78. contextcompass_cli/_package/agent_onboarding/default/draft_writer/policies/draft_writer_handoff_policy.md +20 -0
  79. contextcompass_cli/_package/agent_onboarding/default/draft_writer/policies/draft_writer_quality_policy.md +22 -0
  80. contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer.md +37 -0
  81. contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_advanced_context.md +17 -0
  82. contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_deliverables.md +26 -0
  83. contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_execution.md +23 -0
  84. contextcompass_cli/_package/agent_onboarding/default/draft_writer/workflows/README.md +8 -0
  85. contextcompass_cli/_package/agent_onboarding/default/engineer/AGENTS.MD +493 -0
  86. contextcompass_cli/_package/agent_onboarding/default/engineer/README.md +53 -0
  87. contextcompass_cli/_package/agent_onboarding/default/engineer/SKILLS.MD +263 -0
  88. contextcompass_cli/_package/agent_onboarding/default/engineer/WORKFLOWS.MD +15 -0
  89. contextcompass_cli/_package/agent_onboarding/default/engineer/behavioral_guidelines/engineer_workflow.md +24 -0
  90. contextcompass_cli/_package/agent_onboarding/default/engineer/behavioral_guidelines/task_execution_and_validation.md +34 -0
  91. contextcompass_cli/_package/agent_onboarding/default/engineer/examples/artifact_workflow.md +104 -0
  92. contextcompass_cli/_package/agent_onboarding/default/engineer/examples/eng_task_flow.md +30 -0
  93. contextcompass_cli/_package/agent_onboarding/default/engineer/policies/ctx_autonomy_policy.md +34 -0
  94. contextcompass_cli/_package/agent_onboarding/default/engineer/policies/ctx_autonomy_rubric.md +161 -0
  95. contextcompass_cli/_package/agent_onboarding/default/engineer/policies/engineer_quality_policy.md +33 -0
  96. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/context_protocol.md +70 -0
  97. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/documentation_standards.md +120 -0
  98. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/engineer_execution.md +62 -0
  99. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/package_maintenance.md +195 -0
  100. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/patch_artifact_consumption.md +68 -0
  101. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/patch_framework_gating.md +72 -0
  102. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/src_graph_generation.md +341 -0
  103. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/src_graph_usage.md +161 -0
  104. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/staleness_protocol.md +49 -0
  105. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/system_document_build.md +360 -0
  106. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/system_orientation.md +83 -0
  107. contextcompass_cli/_package/agent_onboarding/default/engineer/skills/technical_expertise.md +48 -0
  108. contextcompass_cli/_package/agent_onboarding/default/engineer/workflows/README.md +9 -0
  109. contextcompass_cli/_package/agent_onboarding/default/general/AGENTS.MD +283 -0
  110. contextcompass_cli/_package/agent_onboarding/default/general/README.md +38 -0
  111. contextcompass_cli/_package/agent_onboarding/default/general/SKILLS.MD +92 -0
  112. contextcompass_cli/_package/agent_onboarding/default/general/WORKFLOWS.MD +23 -0
  113. contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/README.md +12 -0
  114. contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/agent_lifecycle_and_heartbeat.md +37 -0
  115. contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/onboarding_summary.md +41 -0
  116. contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/work_intake_and_execution.md +44 -0
  117. contextcompass_cli/_package/agent_onboarding/default/general/policies/policy_skills.md +174 -0
  118. contextcompass_cli/_package/agent_onboarding/default/general/skills/active_documentation.md +86 -0
  119. contextcompass_cli/_package/agent_onboarding/default/general/skills/active_pointerboard.md +81 -0
  120. contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_identity.md +38 -0
  121. contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_lifecycle.md +21 -0
  122. contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_stance.md +38 -0
  123. contextcompass_cli/_package/agent_onboarding/default/general/skills/career_selection.md +83 -0
  124. contextcompass_cli/_package/agent_onboarding/default/general/skills/compaction_requirements.md +147 -0
  125. contextcompass_cli/_package/agent_onboarding/default/general/skills/configuration_standards.md +72 -0
  126. contextcompass_cli/_package/agent_onboarding/default/general/skills/context_compaction.md +104 -0
  127. contextcompass_cli/_package/agent_onboarding/default/general/skills/context_gold.md +31 -0
  128. contextcompass_cli/_package/agent_onboarding/default/general/skills/context_management.md +79 -0
  129. contextcompass_cli/_package/agent_onboarding/default/general/skills/context_window_budget.md +64 -0
  130. contextcompass_cli/_package/agent_onboarding/default/general/skills/execution_contract.md +234 -0
  131. contextcompass_cli/_package/agent_onboarding/default/general/skills/general.md +22 -0
  132. contextcompass_cli/_package/agent_onboarding/default/general/skills/llm_full_usage.md +111 -0
  133. contextcompass_cli/_package/agent_onboarding/default/general/skills/mailbox_protocol.md +85 -0
  134. contextcompass_cli/_package/agent_onboarding/default/general/skills/memory_management.md +28 -0
  135. contextcompass_cli/_package/agent_onboarding/default/general/skills/mrp_policy.md +40 -0
  136. contextcompass_cli/_package/agent_onboarding/default/general/skills/package_upgrade.md +135 -0
  137. contextcompass_cli/_package/agent_onboarding/default/general/skills/reactive_documentation.md +105 -0
  138. contextcompass_cli/_package/agent_onboarding/default/general/skills/repo_topology.md +25 -0
  139. contextcompass_cli/_package/agent_onboarding/default/general/skills/role_local_workflows.md +41 -0
  140. contextcompass_cli/_package/agent_onboarding/default/general/skills/security_and_secrets.md +46 -0
  141. contextcompass_cli/_package/agent_onboarding/default/general/skills/self_certification.md +49 -0
  142. contextcompass_cli/_package/agent_onboarding/default/general/skills/ticket_closure_attention_sync.md +57 -0
  143. contextcompass_cli/_package/agent_onboarding/default/general/skills/ticket_microcycle.md +44 -0
  144. contextcompass_cli/_package/agent_onboarding/default/general/skills/ticketing.md +175 -0
  145. contextcompass_cli/_package/agent_onboarding/default/general/skills/ticketing_skill_contract.md +52 -0
  146. contextcompass_cli/_package/agent_onboarding/default/general/skills/unknowns_gate_reference.md +66 -0
  147. contextcompass_cli/_package/agent_onboarding/default/general/skills/user_approved_certification.md +32 -0
  148. contextcompass_cli/_package/agent_onboarding/default/general/skills/workflow.md +289 -0
  149. contextcompass_cli/_package/agent_onboarding/default/general/workflows/README.md +9 -0
  150. contextcompass_cli/_package/agent_onboarding/default/general/workflows/cleanup_context_compass.md +205 -0
  151. contextcompass_cli/_package/agent_onboarding/default/general/workflows/role_creation.md +39 -0
  152. contextcompass_cli/_package/agent_onboarding/default/general/workflows/start_context_compass_work.md +102 -0
  153. contextcompass_cli/_package/agent_onboarding/default/general/workflows/sync_attention_board.md +91 -0
  154. contextcompass_cli/_package/agent_onboarding/default/general/workflows/turn_in_selected_tickets.md +95 -0
  155. contextcompass_cli/_package/agent_onboarding/default/general/workflows/workflow_creation.md +38 -0
  156. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/AGENTS.MD +53 -0
  157. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/README.md +42 -0
  158. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/SKILLS.MD +44 -0
  159. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/WORKFLOWS.MD +15 -0
  160. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/behavioral_guidelines/line_copy_editor_workflow.md +23 -0
  161. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/examples/line_copy_editor_task_flow.md +23 -0
  162. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/policies/line_copy_editor_handoff_policy.md +20 -0
  163. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/policies/line_copy_editor_quality_policy.md +22 -0
  164. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor.md +36 -0
  165. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_advanced_context.md +17 -0
  166. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_deliverables.md +25 -0
  167. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_execution.md +23 -0
  168. contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/workflows/README.md +8 -0
  169. contextcompass_cli/_package/agent_onboarding/default/new/AGENTS.MD +79 -0
  170. contextcompass_cli/_package/agent_onboarding/default/new/README.md +54 -0
  171. contextcompass_cli/_package/agent_onboarding/default/new/SKILLS.MD +35 -0
  172. contextcompass_cli/_package/agent_onboarding/default/new/WORKFLOWS.MD +15 -0
  173. contextcompass_cli/_package/agent_onboarding/default/new/behavioral_guidelines/user_onboarding_flow.md +52 -0
  174. contextcompass_cli/_package/agent_onboarding/default/new/policies/new_onboarding_policy.md +59 -0
  175. contextcompass_cli/_package/agent_onboarding/default/new/skills/configuration_map_guide.md +83 -0
  176. contextcompass_cli/_package/agent_onboarding/default/new/skills/first_time_profile_setup.md +60 -0
  177. contextcompass_cli/_package/agent_onboarding/default/new/skills/new.md +54 -0
  178. contextcompass_cli/_package/agent_onboarding/default/new/skills/onboarding_completion_and_next_step.md +54 -0
  179. contextcompass_cli/_package/agent_onboarding/default/new/skills/profile_model_explained.md +120 -0
  180. contextcompass_cli/_package/agent_onboarding/default/new/skills/system_overview_for_user.md +51 -0
  181. contextcompass_cli/_package/agent_onboarding/default/new/workflows/README.md +8 -0
  182. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/AGENTS.MD +63 -0
  183. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/README.md +41 -0
  184. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/SKILLS.MD +62 -0
  185. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/WORKFLOWS.MD +15 -0
  186. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/behavioral_guidelines/incident_workflow.md +17 -0
  187. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/behavioral_guidelines/platform_engineer_workflow.md +18 -0
  188. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/examples/platform_task_flow.md +22 -0
  189. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/operational_safety_policy.md +20 -0
  190. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/platform_quality_policy.md +22 -0
  191. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/production_change_management_policy.md +18 -0
  192. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/ci_cd_and_release.md +28 -0
  193. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/deployment_and_environments.md +25 -0
  194. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/incident_response_and_runbooks.md +35 -0
  195. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/infrastructure_as_code.md +24 -0
  196. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/observability_and_monitoring.md +28 -0
  197. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/performance_capacity_cost.md +20 -0
  198. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/platform_engineer_execution.md +41 -0
  199. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/platform_security_basics.md +25 -0
  200. contextcompass_cli/_package/agent_onboarding/default/platform_engineer/workflows/README.md +8 -0
  201. contextcompass_cli/_package/agent_onboarding/default/proofreader/AGENTS.MD +53 -0
  202. contextcompass_cli/_package/agent_onboarding/default/proofreader/README.md +42 -0
  203. contextcompass_cli/_package/agent_onboarding/default/proofreader/SKILLS.MD +44 -0
  204. contextcompass_cli/_package/agent_onboarding/default/proofreader/WORKFLOWS.MD +15 -0
  205. contextcompass_cli/_package/agent_onboarding/default/proofreader/behavioral_guidelines/proofreader_workflow.md +23 -0
  206. contextcompass_cli/_package/agent_onboarding/default/proofreader/examples/proofreader_task_flow.md +23 -0
  207. contextcompass_cli/_package/agent_onboarding/default/proofreader/policies/proofreader_handoff_policy.md +20 -0
  208. contextcompass_cli/_package/agent_onboarding/default/proofreader/policies/proofreader_quality_policy.md +22 -0
  209. contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader.md +36 -0
  210. contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_advanced_context.md +17 -0
  211. contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_deliverables.md +25 -0
  212. contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_execution.md +23 -0
  213. contextcompass_cli/_package/agent_onboarding/default/proofreader/workflows/README.md +8 -0
  214. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/AGENTS.MD +58 -0
  215. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/README.md +41 -0
  216. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/SKILLS.MD +61 -0
  217. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/WORKFLOWS.MD +15 -0
  218. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/behavioral_guidelines/qa_workflow.md +18 -0
  219. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/behavioral_guidelines/release_signoff_workflow.md +17 -0
  220. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/examples/qa_task_flow.md +24 -0
  221. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/defect_severity_policy.md +24 -0
  222. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/quality_gate_policy.md +18 -0
  223. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/test_evidence_policy.md +18 -0
  224. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/bug_triage_and_repro.md +23 -0
  225. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/qa_engineer_execution.md +29 -0
  226. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/quality_metrics.md +24 -0
  227. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/regression_and_release_quality.md +28 -0
  228. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_automation_practices.md +30 -0
  229. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_case_design.md +27 -0
  230. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_data_and_environments.md +20 -0
  231. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_strategy_and_planning.md +31 -0
  232. contextcompass_cli/_package/agent_onboarding/default/qa_engineer/workflows/README.md +8 -0
  233. contextcompass_cli/_package/agent_onboarding/default/researcher/AGENTS.MD +55 -0
  234. contextcompass_cli/_package/agent_onboarding/default/researcher/README.md +44 -0
  235. contextcompass_cli/_package/agent_onboarding/default/researcher/SKILLS.MD +44 -0
  236. contextcompass_cli/_package/agent_onboarding/default/researcher/WORKFLOWS.MD +15 -0
  237. contextcompass_cli/_package/agent_onboarding/default/researcher/behavioral_guidelines/researcher_workflow.md +23 -0
  238. contextcompass_cli/_package/agent_onboarding/default/researcher/examples/researcher_task_flow.md +25 -0
  239. contextcompass_cli/_package/agent_onboarding/default/researcher/policies/researcher_handoff_policy.md +20 -0
  240. contextcompass_cli/_package/agent_onboarding/default/researcher/policies/researcher_quality_policy.md +22 -0
  241. contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher.md +38 -0
  242. contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_advanced_context.md +17 -0
  243. contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_deliverables.md +27 -0
  244. contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_execution.md +23 -0
  245. contextcompass_cli/_package/agent_onboarding/default/researcher/workflows/README.md +8 -0
  246. contextcompass_cli/_package/agent_onboarding/default/security_engineer/AGENTS.MD +55 -0
  247. contextcompass_cli/_package/agent_onboarding/default/security_engineer/README.md +43 -0
  248. contextcompass_cli/_package/agent_onboarding/default/security_engineer/SKILLS.MD +62 -0
  249. contextcompass_cli/_package/agent_onboarding/default/security_engineer/WORKFLOWS.MD +15 -0
  250. contextcompass_cli/_package/agent_onboarding/default/security_engineer/behavioral_guidelines/security_signoff_and_escalation.md +22 -0
  251. contextcompass_cli/_package/agent_onboarding/default/security_engineer/behavioral_guidelines/security_workflow.md +18 -0
  252. contextcompass_cli/_package/agent_onboarding/default/security_engineer/examples/security_review_flow.md +22 -0
  253. contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/risk_acceptance_policy.md +17 -0
  254. contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/secrets_and_keys_policy.md +19 -0
  255. contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/security_review_policy.md +22 -0
  256. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/authn_authz_basics.md +24 -0
  257. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/dependency_and_supply_chain.md +20 -0
  258. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/incident_response_security.md +22 -0
  259. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/logging_audit_privacy.md +16 -0
  260. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/secure_architecture_review.md +20 -0
  261. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/secure_coding_review.md +22 -0
  262. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/security_engineer_execution.md +28 -0
  263. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/threat_modeling.md +25 -0
  264. contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/vulnerability_management.md +22 -0
  265. contextcompass_cli/_package/agent_onboarding/default/security_engineer/workflows/README.md +8 -0
  266. contextcompass_cli/_package/agent_onboarding/default/story_designer/AGENTS.MD +56 -0
  267. contextcompass_cli/_package/agent_onboarding/default/story_designer/README.md +45 -0
  268. contextcompass_cli/_package/agent_onboarding/default/story_designer/SKILLS.MD +44 -0
  269. contextcompass_cli/_package/agent_onboarding/default/story_designer/WORKFLOWS.MD +15 -0
  270. contextcompass_cli/_package/agent_onboarding/default/story_designer/behavioral_guidelines/story_designer_workflow.md +23 -0
  271. contextcompass_cli/_package/agent_onboarding/default/story_designer/examples/story_designer_task_flow.md +26 -0
  272. contextcompass_cli/_package/agent_onboarding/default/story_designer/policies/story_designer_handoff_policy.md +20 -0
  273. contextcompass_cli/_package/agent_onboarding/default/story_designer/policies/story_designer_quality_policy.md +22 -0
  274. contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer.md +39 -0
  275. contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_advanced_context.md +17 -0
  276. contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_deliverables.md +28 -0
  277. contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_execution.md +23 -0
  278. contextcompass_cli/_package/agent_onboarding/default/story_designer/workflows/README.md +8 -0
  279. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/AGENTS.MD +56 -0
  280. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/README.md +45 -0
  281. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/SKILLS.MD +44 -0
  282. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/WORKFLOWS.MD +15 -0
  283. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/behavioral_guidelines/story_novel_artist_workflow.md +23 -0
  284. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/examples/story_novel_artist_task_flow.md +26 -0
  285. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/policies/story_novel_artist_handoff_policy.md +20 -0
  286. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/policies/story_novel_artist_quality_policy.md +22 -0
  287. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist.md +39 -0
  288. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_advanced_context.md +17 -0
  289. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_deliverables.md +28 -0
  290. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_execution.md +23 -0
  291. contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/workflows/README.md +8 -0
  292. contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/AGENTS.MD +66 -0
  293. contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/SKILLS.MD +15 -0
  294. contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/WORKFLOWS.MD +15 -0
  295. contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/behavioral_guidelines/data_engineer_behavior_overrides.md +6 -0
  296. contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/policies/data_engineer_policy_overrides.md +6 -0
  297. contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/profile_overrides.md +9 -0
  298. contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/skills/data_engineer_skill_overrides.md +6 -0
  299. contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/workflows/README.md +8 -0
  300. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/AGENTS.MD +145 -0
  301. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/SKILLS.MD +37 -0
  302. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/WORKFLOWS.MD +17 -0
  303. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/behavioral_guidelines/synaptic_finishing_developer_behavior_overrides.md +12 -0
  304. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/comment_finishing_examples.py +65 -0
  305. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/docstring_finishing_examples.py +126 -0
  306. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_component_finishing_examples.py +51 -0
  307. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_integration_finishing_examples.py +59 -0
  308. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_unit_finishing_examples.py +66 -0
  309. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/policies/synaptic_finishing_developer_policy_overrides.md +14 -0
  310. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/profile_overrides.md +17 -0
  311. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/comment_craft.md +51 -0
  312. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/docstring_craft.md +86 -0
  313. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/docstring_test_alignment.md +51 -0
  314. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/system_aware_docstrings.md +64 -0
  315. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/synaptic_finishing_developer_skill_overrides.md +11 -0
  316. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/component_tests.md +45 -0
  317. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/evidence_reporting.md +25 -0
  318. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/mocking.md +35 -0
  319. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/pytest_integration.md +32 -0
  320. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/pytest_unit.md +49 -0
  321. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/regression_tests.md +24 -0
  322. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/testing_overview.md +71 -0
  323. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/README.md +8 -0
  324. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/optimize_pytests_for_repo.md +272 -0
  325. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/polish_repo_documentation.md +247 -0
  326. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/AGENTS.MD +386 -0
  327. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/README.md +31 -0
  328. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/SKILLS.MD +44 -0
  329. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/WORKFLOWS.MD +16 -0
  330. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/behavioral_guidelines/synaptic_behavior_overrides.md +17 -0
  331. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/anti_patterns.py +19 -0
  332. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/cleanup_patterns.py +22 -0
  333. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/docstrings.py +19 -0
  334. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/logging_patterns.py +11 -0
  335. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/protocols_and_abc.py +15 -0
  336. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_component_examples.py +15 -0
  337. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_integration_examples.py +17 -0
  338. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_unit_examples.py +13 -0
  339. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/policies/synaptic_policy_overrides.md +22 -0
  340. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/profile_overrides.md +27 -0
  341. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/attribute_aliasing_skill_benchmark.py +35 -0
  342. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/banned_patterns.md +110 -0
  343. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/cleanup_and_disposal.md +79 -0
  344. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/comments.md +39 -0
  345. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/docstrings.md +90 -0
  346. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/error_model.md +28 -0
  347. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/hot_path_attribute_aliasing.md +52 -0
  348. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/init_and_ownership.md +35 -0
  349. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/interfaces.md +47 -0
  350. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/logging.md +37 -0
  351. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/module_scope.md +38 -0
  352. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/refactor_limits.md +44 -0
  353. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/typing.md +52 -0
  354. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/synaptic_skill_overrides.md +24 -0
  355. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/evidence_reporting.md +35 -0
  356. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/mocking.md +31 -0
  357. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/pytest_integration.md +36 -0
  358. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/pytest_unit.md +42 -0
  359. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/regression_tests.md +26 -0
  360. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/testing_overview.md +196 -0
  361. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/workflows/README.md +8 -0
  362. contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/workflows/synaptic_python_developer_onboarding.md +226 -0
  363. contextcompass_cli/_package/artifact_board.md +64 -0
  364. contextcompass_cli/_package/artifacts/IMPORTANT_CONSIDERATION.md +43 -0
  365. contextcompass_cli/_package/artifacts/README.md +41 -0
  366. contextcompass_cli/_package/attention_board.md +79 -0
  367. contextcompass_cli/_package/config/context_compass_config.yaml +101 -0
  368. contextcompass_cli/_package/context_management/README.md +21 -0
  369. contextcompass_cli/_package/context_management/artifacts/.gitkeep +1 -0
  370. contextcompass_cli/_package/context_management/context_artifact_template.md +42 -0
  371. contextcompass_cli/_package/context_management/context_board.md +27 -0
  372. contextcompass_cli/_package/examples/adr_example.md +29 -0
  373. contextcompass_cli/_package/examples/artifact_workflow.md +20 -0
  374. contextcompass_cli/_package/examples/continuity_fact_checker_task_flow.md +23 -0
  375. contextcompass_cli/_package/examples/design_task_flow.md +35 -0
  376. contextcompass_cli/_package/examples/developmental_editor_task_flow.md +22 -0
  377. contextcompass_cli/_package/examples/draft_writer_task_flow.md +23 -0
  378. contextcompass_cli/_package/examples/eng_task_flow.md +31 -0
  379. contextcompass_cli/_package/examples/example_architecture/.gitkeep +0 -0
  380. contextcompass_cli/_package/examples/example_architecture/src_architecture.md +136 -0
  381. contextcompass_cli/_package/examples/example_architecture/src_architecture_index.md +46 -0
  382. contextcompass_cli/_package/examples/example_architecture/tests_architecture.md +148 -0
  383. contextcompass_cli/_package/examples/example_architecture/tests_architecture_index.md +46 -0
  384. contextcompass_cli/_package/examples/example_completed/.gitkeep +0 -0
  385. contextcompass_cli/_package/examples/example_completed/2026-02-19_context_compass_release_overview_artifact.md +33 -0
  386. contextcompass_cli/_package/examples/example_components/.gitkeep +0 -0
  387. contextcompass_cli/_package/examples/example_components/src_components.md +169 -0
  388. contextcompass_cli/_package/examples/example_components/src_components_index.md +44 -0
  389. contextcompass_cli/_package/examples/example_components/tests_components.md +96 -0
  390. contextcompass_cli/_package/examples/example_components/tests_components_index.md +42 -0
  391. contextcompass_cli/_package/examples/example_epics/.gitkeep +0 -0
  392. contextcompass_cli/_package/examples/example_epics/2026-02-19_context_compass_release_readiness_example_pack_epic.md +130 -0
  393. contextcompass_cli/_package/examples/example_graph_details/README.md +131 -0
  394. contextcompass_cli/_package/examples/example_graph_details/src/example/__init__.py +4 -0
  395. contextcompass_cli/_package/examples/example_graph_details/src/example/core/interfaces.py +10 -0
  396. contextcompass_cli/_package/examples/example_graph_details/src/example/core/resource.py +15 -0
  397. contextcompass_cli/_package/examples/example_graph_details/src/example/pipeline/pipeline.py +20 -0
  398. contextcompass_cli/_package/examples/example_graph_details/src/example/pipeline/stage.py +11 -0
  399. contextcompass_cli/_package/examples/example_graph_details/src/example/storage/store.py +20 -0
  400. contextcompass_cli/_package/examples/example_graph_details/src_graph.md +192 -0
  401. contextcompass_cli/_package/examples/example_graph_details/src_graph_index.md +32 -0
  402. contextcompass_cli/_package/examples/example_stories/.gitkeep +0 -0
  403. contextcompass_cli/_package/examples/example_stories/2026-02-19_context_compass_release_readiness_examples_story.md +120 -0
  404. contextcompass_cli/_package/examples/example_tasks/.gitkeep +0 -0
  405. contextcompass_cli/_package/examples/example_tasks/2026-02-19_context_compass_release_readiness_pack_task.md +147 -0
  406. contextcompass_cli/_package/examples/line_copy_editor_task_flow.md +23 -0
  407. contextcompass_cli/_package/examples/platform_task_flow.md +26 -0
  408. contextcompass_cli/_package/examples/proofreader_task_flow.md +23 -0
  409. contextcompass_cli/_package/examples/qa_task_flow.md +26 -0
  410. contextcompass_cli/_package/examples/repo_overview.md +63 -0
  411. contextcompass_cli/_package/examples/researcher_task_flow.md +23 -0
  412. contextcompass_cli/_package/examples/security_review_flow.md +24 -0
  413. contextcompass_cli/_package/examples/story_designer_task_flow.md +23 -0
  414. contextcompass_cli/_package/examples/story_novel_artist_task_flow.md +22 -0
  415. contextcompass_cli/_package/mailbox_board.md +79 -0
  416. contextcompass_cli/_package/special_instructions/README.md +16 -0
  417. contextcompass_cli/_package/system_docs/.gitkeep +0 -0
  418. contextcompass_cli/_package/system_docs/patches/active/README.md +25 -0
  419. contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/architecture_patch.md +53 -0
  420. contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/code_description_patch_TEMPLATE_COMPONENT.md +39 -0
  421. contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/component_patch_TEMPLATE_COMPONENT.md +48 -0
  422. contextcompass_cli/_package/system_docs/system_docs_read_first.md +107 -0
  423. contextcompass_cli/_package/templates/epic_template.md +149 -0
  424. contextcompass_cli/_package/templates/story_template.md +131 -0
  425. contextcompass_cli/_package/templates/task_template.md +124 -0
  426. contextcompass_cli/_package/templates/workflow_advanced_template.md +111 -0
  427. contextcompass_cli/_package/templates/workflow_simple_template.md +65 -0
  428. contextcompass_cli/_package/tickets/README.md +24 -0
  429. contextcompass_cli/_package/tickets/epics/README.md +68 -0
  430. contextcompass_cli/_package/tickets/epics/archive/.gitkeep +0 -0
  431. contextcompass_cli/_package/tickets/epics/backlog/.gitkeep +0 -0
  432. contextcompass_cli/_package/tickets/epics/completed/.gitkeep +0 -0
  433. contextcompass_cli/_package/tickets/stories/README.md +68 -0
  434. contextcompass_cli/_package/tickets/stories/archive/.gitkeep +0 -0
  435. contextcompass_cli/_package/tickets/stories/backlog/.gitkeep +0 -0
  436. contextcompass_cli/_package/tickets/stories/completed/.gitkeep +0 -0
  437. contextcompass_cli/_package/tickets/tasks/README.md +67 -0
  438. contextcompass_cli/_package/tickets/tasks/archive/.gitkeep +0 -0
  439. contextcompass_cli/_package/tickets/tasks/backlog/.gitkeep +0 -0
  440. contextcompass_cli/_package/tickets/tasks/completed/.gitkeep +0 -0
  441. contextcompass_cli/_package/tools/build_llm_full.py +307 -0
  442. contextcompass_cli/_package/tools/cleanup_context_compass.py +488 -0
  443. contextcompass_cli/_package/tools/migrate_boards.py +218 -0
  444. contextcompass_cli/_package/tools/package_manifest.py +351 -0
  445. contextcompass_cli/_package/tools/system_documents/index_document.py +476 -0
  446. contextcompass_cli/_package/tools/system_documents/python/assemble_graph.py +387 -0
  447. contextcompass_cli/_package/tools/system_documents/python/extract_graph.py +626 -0
  448. contextcompass_cli/_package/tools/system_documents/python/graph_semantics_tickets.py +405 -0
  449. contextcompass_cli/_package/tools/system_documents/python/graph_walker.py +375 -0
  450. contextcompass_cli/_package/tools/system_documents/python/migrate_authored_graph.py +179 -0
  451. contextcompass_cli/_package/tools/update_context_compass.py +511 -0
  452. 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
+
@@ -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
+
@@ -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
+