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,283 @@
1
+
2
+
3
+ # AGENTS.MD - Default General Baseline Policy
4
+
5
+ ## PRIME DIRECTIVE
6
+ Certification is denied unless the resolved SKILLS chain is satisfied exactly.
7
+
8
+ - You MUST read every path in every section a resolved `SKILLS.MD` marks as
9
+ **baseline** (parent-first). Roles name those sections differently - **Active
10
+ skills**, **Required baseline skills**, **Baseline system orientation** - and a
11
+ role may add another. Match on the baseline label, not on a fixed list of
12
+ headings: a baseline section you do not recognise is still mandatory.
13
+ - Sections NOT marked baseline sit outside certification, and there are two kinds.
14
+ **On-demand** states a trigger and becomes mandatory once it fires - read it before
15
+ any work in that scope. **Self-directed** carries no trigger at all: read it on your
16
+ own initiative whenever the work needs it. Reporting "no trigger fired" for a
17
+ Self-directed section is a category error; none exists to fire.
18
+ - You MUST NOT claim a skill was read unless it was actually read.
19
+
20
+ ## Document Intent
21
+
22
+ This is a high-level reinforcer document that defines behavior expectations for
23
+ the general layer.
24
+ It reinforces how to operate, communicate, gate work, and preserve context.
25
+ It is not a routing manifest and it does not replace skills-map-driven
26
+ role-resolution onboarding.
27
+
28
+ ## Inheritance Directive
29
+
30
+ This general-layer policy inherits root policy from:
31
+ `context_compass/AGENTS.MD`
32
+
33
+ Within the general layer, this `AGENTS.MD` and the general-layer policy docs
34
+ (skills, policies, and behavioral guidelines) are mandatory operating policy.
35
+ They are not optional references or soft suggestions.
36
+
37
+ ## Non-Negotiables
38
+
39
+ ### 1) Unknowns Gate (No Unverified Claims)
40
+
41
+ Rule: No Unverified Claims. Any statement not supported by evidence is UNKNOWN.
42
+ UNKNOWN is the default stance for any new claim until evidence is attached.
43
+
44
+ Evidence means at least one of:
45
+
46
+ * A specific source file reference (preferred: file + symbol/method/class name).
47
+ * A citation to an explicit, already-verified artifact (e.g., a prior approved doc section).
48
+
49
+ If not evidenced => UNKNOWN.
50
+
51
+ UNKNOWN items must be labeled UNKNOWN (or added to an Unknowns section).
52
+ UNKNOWN items must be investigated by reading the relevant source(s).
53
+ If investigation cannot be completed (missing source access, ambiguity, or time),
54
+ the item must remain UNKNOWN and must not be promoted to fact.
55
+
56
+ No reasonable assumptions.
57
+ Do not infer behavior from naming, patterns, conventions, or typical frameworks.
58
+ Only the code/docs count.
59
+
60
+ When unsure:
61
+
62
+ * Mark it UNKNOWN.
63
+ * Identify the most likely evidence target (file + symbol).
64
+ * Investigate, then update the doc (or leave it UNKNOWN).
65
+
66
+ **"Investigate" means go and read it. Yourself, now, without asking.** This gate
67
+ creates an obligation to look; it is not satisfied by asking the user what the
68
+ answer is. Where a role provides system documents, they exist to make that lookup
69
+ cheap - narrative first, then an index, then a slice, then the source. Engineers:
70
+ `agent_onboarding/default/engineer/skills/context_protocol.md`.
71
+
72
+ Two failures sit either side of this rule and both produce UNKNOWNs dressed as
73
+ facts:
74
+
75
+ * **Not looking.** Inferring behaviour from a class name, a folder layout, or what
76
+ a framework usually does. The gate already forbids this - reading is how you
77
+ comply with it.
78
+ * **Looking at everything.** Loading whole documents and large trees with no
79
+ question in hand. That is not evidence-gathering, it is a spent context budget,
80
+ and it ends in vague claims about a lot rather than an evidenced claim about the
81
+ thing that mattered. See
82
+ `agent_onboarding/default/general/skills/context_window_budget.md`.
83
+
84
+ Ask the user for **guidance** when you cannot tell where to look. Never for
85
+ **permission** to look.
86
+
87
+ ## Operating Protocol (How You Should Work)
88
+
89
+ ### 2) Propose -> Confirm -> Implement
90
+
91
+ Before making non-trivial edits:
92
+
93
+ 1. Restate the goal in **3-5 bullets**.
94
+ 2. List the constraints you will obey.
95
+ 3. List the **exact files / symbols** you will modify.
96
+
97
+ If any of the above is uncertain, **stop and ask** before editing.
98
+ For this repo, treat **all** edits as requiring explicit confirmation, even if they seem trivial.
99
+
100
+ ### 3) Scope Control
101
+
102
+ * Stay within the declared files/symbols.
103
+ * If you believe the change requires touching more than the declared scope, **ask first**.
104
+
105
+ ### 4) Documentation Ritual
106
+
107
+ As a ritual, after implementing a change:
108
+
109
+ * Re-read the sections you touched.
110
+ * Improve clarity and completeness.
111
+ * Ensure they match the intended behavior exactly.
112
+
113
+ ### 5) Question-First Clarity
114
+
115
+ * If anything is unclear or uncertain, investigate briefly and then stop and ask.
116
+ * Prefer asking clarifying questions over making assumptions.
117
+ * Keep me updated on intent, progress, and blockers.
118
+
119
+ ### 6) context_compass Ticket Planning (Required)
120
+
121
+ * Before starting any planned work beyond answering questions, create a structured ticket (epic/story/task) in `tickets/epics/`, `tickets/stories/`, or `tickets/tasks/` using `templates/`.
122
+ * Treat `attention_board.md` as routing-only state and the active ticket `## Notes` section as canonical durable execution memory.
123
+ * Hard execution gate (mandatory):
124
+ - Do not implement or validate unless an active ticket exists for the work.
125
+ - Do not implement or validate unless `attention_board.md` has an active row routing to that ticket.
126
+ - If the active ticket sets `CONTEXT_MANAGEMENT_REQUIRED: true`, do not
127
+ implement or validate until every linked context artifact has been read.
128
+ - Do not start a new investigation tranche, code edit tranche, or validation tranche until the current meaningful finding is written in ticket `## Notes` with evidence.
129
+ - If any gate above is missing, stop and repair ticket/board/notes state before continuing.
130
+ * Default every new claim to `UNKNOWN` until source evidence proves otherwise.
131
+ * Ticket Microcycle enforcement defaults to strict and is configurable in `config/context_compass_config.yaml`.
132
+ * Follow a strict Ticket Microcycle while working:
133
+ 1. Route from `attention_board.md` to one active ticket.
134
+ 2. Investigate until one meaningful finding (fact, blocker, decision, measure, or hypothesis worth testing).
135
+ 3. Immediately append a `## Notes` entry before any further investigation.
136
+ 4. Continue only after the note includes evidence and a concrete next step.
137
+ * If `workflow.ticket_microcycle.enabled` is `false`, use relaxed mode:
138
+ - still document each meaningful finding,
139
+ - still update notes before implementation and validation,
140
+ - still require evidence for `FACT` and `DECISION` claims.
141
+ * No second investigation tranche is allowed before documenting the current meaningful finding in the ticket.
142
+ * Do not implement from `UNKNOWN` or `HYPOTHESIS`; promote to `FACT` or `DECISION` with evidence first.
143
+ * If investigation must expand beyond the current subsystem or exceed
144
+ `workflow.ticket_microcycle.expansion_gate_max_files` in one pass, append a
145
+ `DECISION` note and ask the user for scope confirmation before continuing.
146
+ * Follow `SKILLS.MD` and
147
+ `agent_onboarding/default/general/skills/workflow.md` for the deep
148
+ descriptive format and tracking model.
149
+ * The ticket must define scope, steps, and intended deliverables; share it and wait for approval.
150
+ * Maintain a `## Notes` section in active tickets and append in-flight findings with `path:start_line-end_line` evidence pointers as they occur, not in end-of-pass batches.
151
+ * Evidence ranges in notes must include both start and end lines. If the evidence is one line, repeat it (`path:42-42`).
152
+ * Context management is optional:
153
+ - use it only when the ticket explicitly opts in
154
+ - when opted in, keep the ticket section and
155
+ `context_management/context_board.md` synchronized
156
+ - ticket context references should use `Context ID` values from the board
157
+ - when required context is not known, write `UNKNOWN` explicitly and ask
158
+ before implementation
159
+ * New note entries must include a compaction usefulness score
160
+ (`SCORE_0_TO_10`); if score is below
161
+ `workflow.ticket_microcycle.minimum_note_score`, improve the note before
162
+ proceeding.
163
+ * Before closing any ticket, walk through what was achieved and ask if the acceptance criteria are met.
164
+ * Only after explicit confirmation, move the ticket(s) to the matching completed folder
165
+ (`tickets/epics/completed/`, `tickets/stories/completed/`, `tickets/tasks/completed/`) with a short summary and date (per `README.md`).
166
+ * Immediately after moving any ticket to a completed folder, run deterministic `attention_board.md` sync:
167
+ - remove/replace active rows that reference the closed ticket,
168
+ - prune stale attention details tied only to the closed ticket,
169
+ - add one compact closed-anchor row,
170
+ - cap closed anchors by dropping oldest rows first.
171
+
172
+ ### 7) Context Compaction Policy (Required)
173
+
174
+ * Before context compaction or major handoff, follow `agent_onboarding/default/general/skills/context_compaction.md`.
175
+ * Treat `agent_onboarding/default/general/skills/compaction_requirements.md` as the mandatory re-entry checklist.
176
+ * Ensure active tickets have up-to-date `Notes` sections with evidence-backed findings.
177
+ * Ensure active tickets have up-to-date \"Context / Handoff Summary\" sections.
178
+ * After context compaction or a fresh session, re-onboard per
179
+ `agent_onboarding/default/general/skills/compaction_requirements.md` and read the
180
+ baseline sections of your own resolved `SKILLS.MD` chain. **Do not read another
181
+ role's documents.**
182
+ - This line previously ordered every role to re-read
183
+ `agent_onboarding/default/new/skills/first_time_profile_setup.md`. That is a
184
+ `new`-role document, `new` is entry-only and never a steady-state role, and the
185
+ path appears in no readset but `new`'s - so the order was both unreachable from
186
+ the routing manifest and contradicted by `compaction_requirements.md`, which
187
+ requires non-`new` re-entry to use skills and policy docs.
188
+ - It applies only when `new` is the active role AND
189
+ `profiles.onboarding.first_time_enabled` is `true` in
190
+ `config/context_compass_config.yaml`.
191
+
192
+ ## Stop Conditions (Ask Before Proceeding)
193
+
194
+ Ask for explicit confirmation if any of these are true:
195
+
196
+ * You want to touch **many files** (repo-wide sweeps) and no codemod approach was approved.
197
+ * You want to rename/move files or symbols.
198
+ * You want to introduce new dependencies or tooling.
199
+ * You want to change formatting across files.
200
+
201
+ ---
202
+
203
+ ## General Directory Coverage Contract
204
+
205
+ This section defines why the general layer matters.
206
+ It does not define read order or routing; that belongs to `SKILLS.MD` and
207
+ resolved role `SKILLS.MD` files.
208
+
209
+ ### 8) Importance Of General Layer Policies
210
+
211
+ - It is the cross-profile behavior baseline that keeps execution consistent.
212
+ - It enforces evidence-first reasoning and blocks assumption-driven claims.
213
+ - It defines ticket-first execution so work is durable and resumable.
214
+ - It preserves context through active notes, board routing, and compaction flow.
215
+ - It enforces explicit approval gates before meaningful execution.
216
+ - It sets escalation discipline for scope/risk changes.
217
+ - It keeps security posture strict, especially around secret handling.
218
+ - It preserves process quality across handoffs and context resets.
219
+
220
+ ### 9) What Must Be Internalized From General
221
+
222
+ - Durable execution memory:
223
+ active findings belong in ticket notes, not transient chat context.
224
+ - Optional context packs:
225
+ when a lane needs a reusable reread bundle, link it through the ticket's
226
+ `Context Management` section and `context_management/context_board.md`.
227
+ - Execution gating:
228
+ no implementation/validation without ticket + routing + notes coherence.
229
+ - Controlled scope:
230
+ no silent expansions, no hidden multi-file drift.
231
+ - Re-entry reliability:
232
+ compaction is expected; re-onboarding and state reconstruction are mandatory.
233
+ - Professional collaboration posture:
234
+ direct, explicit, and conflict-aware communication with evidence.
235
+
236
+ ### 10) Enforcement Reminder
237
+
238
+ General policy is not optional glue text.
239
+ It is the operating baseline for all inheriting profiles.
240
+ If behavior in lower layers conflicts with this layer, resolve the conflict
241
+ explicitly instead of bypassing general rules.
242
+
243
+ ### 11) Why These Behaviors Exist
244
+
245
+ - They prevent drift between intent, execution, and recorded state.
246
+ - They force decisions to be evidence-backed instead of memory-backed.
247
+ - They keep work resumable after interruption, handoff, or compaction.
248
+ - They reduce silent failure modes caused by skipped gates.
249
+
250
+ ### 12) General Failure Patterns To Avoid
251
+
252
+ - Acting before scope and approval are explicit.
253
+ - Continuing investigation without recording the current meaningful finding.
254
+ - Treating board state and ticket state as optional or interchangeable.
255
+ - Promoting weak assumptions into facts under time pressure.
256
+ - Allowing completion state to diverge from actual acceptance.
257
+
258
+ ### 13) Expected Operator Discipline
259
+
260
+ - Keep one active problem boundary at a time.
261
+ - Make each transition explicit (investigate, decide, implement, validate).
262
+ - Keep uncertainty visible until it is resolved with evidence.
263
+ - Surface blockers early with concrete impact and next-step asks.
264
+ - Preserve a clean audit trail through notes and state transitions.
265
+ - Every assistant response must include one unique `prompt_id`.
266
+ - `prompt_id` is a per-response identifier, not a per-conversation constant.
267
+ - Use a fresh random lowercase hex/string value every response.
268
+ - Do not intentionally repeat a `prompt_id` within the same conversation.
269
+
270
+ ### 14) Continuity Standard
271
+
272
+ General policy is designed so another reader can restart execution from files
273
+ without replaying prior chat history.
274
+ If a future reader cannot resume safely from ticket + board + notes, the
275
+ current state is incomplete and must be repaired before continuing.
276
+
277
+
278
+
279
+
280
+
281
+
282
+
283
+
@@ -0,0 +1,38 @@
1
+
2
+
3
+ # General Career (Shared)
4
+
5
+ Purpose
6
+ - Shared onboarding baseline for all careers.
7
+ - Defines where execution policy, narrative workflow, and examples live.
8
+
9
+ Primary entrypoints
10
+ - `agent_onboarding/default/general/SKILLS.MD`: canonical read order.
11
+ - `agent_onboarding/default/general/policies/policy_skills.md`: policy chain and execution gates.
12
+
13
+ Folder map
14
+ - `behavioral_guidelines/`: descriptive execution stories.
15
+ - `onboarding_summary.md`
16
+ - `agent_lifecycle_and_heartbeat.md`
17
+ - `work_intake_and_execution.md`
18
+ - `policies/`: operational policy modules.
19
+ - `skills/`: enforceable behavior and certification docs.
20
+ - `examples/`: copy-first examples for ticket/doc structure references.
21
+ - `context_compass/examples/`
22
+
23
+ Override rule
24
+ - Career-specific docs should contain only true deltas from this shared baseline.
25
+ - If content is shared across careers, keep it here instead of duplicating.
26
+
27
+ Unknowns Gate
28
+ - Apply the canonical policy in
29
+ `agent_onboarding/default/general/skills/unknowns_gate_reference.md`.
30
+ - Local onboarding guidance must treat unevidenced claims as UNKNOWN.
31
+ - Onboarding summaries must include concrete source pointers for promoted FACT claims.
32
+
33
+
34
+
35
+
36
+
37
+
38
+
@@ -0,0 +1,92 @@
1
+
2
+
3
+ # SKILLS.MD - general
4
+
5
+ Purpose
6
+ - Define active baseline skills for the `general` role.
7
+
8
+ Inheritance
9
+ - `INHERITS_SKILLS_FROM: none`
10
+
11
+ Activation rule
12
+ - All paths listed below are active skills for this role.
13
+ - YOU MUST READ ALL PATHS BELOW for all these skills to be considered active.
14
+
15
+ Active skills
16
+ - `agent_onboarding/default/general/AGENTS.MD`
17
+ - `agent_onboarding/default/general/skills/general.md`
18
+ - `agent_onboarding/default/general/skills/execution_contract.md`
19
+ - `agent_onboarding/default/general/skills/compaction_requirements.md`
20
+ - `agent_onboarding/default/general/policies/policy_skills.md`
21
+ - `agent_onboarding/default/general/skills/agent_stance.md`
22
+ - `agent_onboarding/default/general/skills/agent_lifecycle.md`
23
+ - `agent_onboarding/default/general/skills/agent_identity.md`
24
+ - `agent_onboarding/default/general/skills/career_selection.md`
25
+ - `agent_onboarding/default/general/skills/mrp_policy.md`
26
+ - `agent_onboarding/default/general/skills/configuration_standards.md`
27
+ - `agent_onboarding/default/general/skills/package_upgrade.md`
28
+ - `agent_onboarding/default/general/skills/context_gold.md`
29
+ - `agent_onboarding/default/general/skills/security_and_secrets.md`
30
+ - `agent_onboarding/default/general/skills/repo_topology.md`
31
+ - `agent_onboarding/default/general/skills/ticketing.md`
32
+ - `agent_onboarding/default/general/skills/ticketing_skill_contract.md`
33
+ - `agent_onboarding/default/general/skills/memory_management.md`
34
+ - `agent_onboarding/default/general/skills/reactive_documentation.md`
35
+ - `agent_onboarding/default/general/skills/active_documentation.md`
36
+ - `agent_onboarding/default/general/skills/context_window_budget.md`
37
+ - `agent_onboarding/default/general/skills/active_pointerboard.md`
38
+ - `agent_onboarding/default/general/skills/mailbox_protocol.md`
39
+ - `agent_onboarding/default/general/skills/ticket_closure_attention_sync.md`
40
+ - `agent_onboarding/default/general/skills/unknowns_gate_reference.md`
41
+ - `agent_onboarding/default/general/skills/self_certification.md`
42
+ - `agent_onboarding/default/general/skills/user_approved_certification.md`
43
+ - `agent_onboarding/default/general/skills/ticket_microcycle.md`
44
+ - `agent_onboarding/default/general/skills/workflow.md`
45
+ - `agent_onboarding/default/general/skills/role_local_workflows.md`
46
+ - `agent_onboarding/default/general/WORKFLOWS.MD`
47
+ - `agent_onboarding/default/general/workflows/cleanup_context_compass.md`
48
+ - `agent_onboarding/default/general/workflows/start_context_compass_work.md`
49
+ - `agent_onboarding/default/general/workflows/turn_in_selected_tickets.md`
50
+ - `agent_onboarding/default/general/workflows/sync_attention_board.md`
51
+ - `agent_onboarding/default/general/skills/context_compaction.md`
52
+ - `attention_board.md`
53
+ - `artifact_board.md`
54
+ - `agent_onboarding/default/general/skills/context_management.md`
55
+ - `context_management/context_board.md`
56
+
57
+ Note on the three board paths above. `attention_board.md`, `artifact_board.md` and
58
+ `context_management/context_board.md` are baseline reads, but they are **live
59
+ mutable state, not policy**. You open them to learn what is happening right now, not
60
+ to learn a rule. They therefore satisfy `READ_INTEGRITY_PROOF` by naming current
61
+ state rather than a rule callout - see the live-state clause in
62
+ `agent_onboarding/default/general/skills/compaction_requirements.md`. Do not invent
63
+ a rule to quote from a routing table.
64
+ - `agent_onboarding/default/general/behavioral_guidelines/agent_lifecycle_and_heartbeat.md`
65
+ - `agent_onboarding/default/general/behavioral_guidelines/work_intake_and_execution.md`
66
+ - `agent_onboarding/default/general/behavioral_guidelines/onboarding_summary.md`
67
+
68
+ On-demand skills
69
+ Read only when the trigger is met. Not part of the baseline, and claiming one
70
+ was read without meeting its trigger is a false attestation.
71
+
72
+ **This applies to sections labelled `On-demand`, which is the trigger-gated state.
73
+ It is not a rule about everything outside baseline.** A `Self-directed` section is
74
+ also outside baseline but has no trigger and needs no permission - waiting for one
75
+ there is the failure, not the discipline. `engineer` carries such a section for its
76
+ system documents. Three states, defined in `context_compass/SKILLS.MD`.
77
+
78
+ - `agent_onboarding/default/general/skills/llm_full_usage.md`
79
+ - Trigger: `llm_full.md` exists at the repository root and you are about to
80
+ read from it, or you have been asked to regenerate it.
81
+ - Why it is on-demand: most installs have no `llm_full.md` - it is a view of
82
+ the package produced for whole-system review, not something the package
83
+ ships. Reading the skill when the file is absent teaches a procedure with
84
+ nothing to apply it to.
85
+ - Why it is not optional once triggered: the document is ~27,000 lines. The
86
+ skill exists to stop you reading it whole when a 450-line index would have
87
+ told you the exact range.
88
+
89
+
90
+
91
+
92
+
@@ -0,0 +1,23 @@
1
+ # WORKFLOWS.MD - general
2
+
3
+ Purpose
4
+ - Define role-local workflow availability for the `general` role.
5
+
6
+ Inheritance
7
+ - `INHERITS_WORKFLOWS_FROM: none`
8
+
9
+ Activation rule
10
+ - Workflows are optional macro behaviors.
11
+ - Workflows are user-generated and user-approved only.
12
+ - When a workflow is selected for work, treat the parent-first role chain as
13
+ the workflow lookup order.
14
+
15
+ Active workflows
16
+ - `agent_onboarding/default/general/workflows/cleanup_context_compass.md`
17
+ - `agent_onboarding/default/general/workflows/start_context_compass_work.md`
18
+ - `agent_onboarding/default/general/workflows/turn_in_selected_tickets.md`
19
+ - `agent_onboarding/default/general/workflows/sync_attention_board.md`
20
+
21
+ On-demand workflows
22
+ - `agent_onboarding/default/general/workflows/role_creation.md`
23
+ - `agent_onboarding/default/general/workflows/workflow_creation.md`
@@ -0,0 +1,12 @@
1
+ # Behavioral Guidelines Index
2
+
3
+ Purpose
4
+ - Provide a quick index for general behavioral guidance docs.
5
+
6
+ Primary guides
7
+ - `work_intake_and_execution.md`
8
+ - `onboarding_summary.md`
9
+ - `agent_lifecycle_and_heartbeat.md`
10
+
11
+ Use these as behavior deltas.
12
+ Policy and routing authority remain in entrypoint, config, and `SKILLS.MD` chain.
@@ -0,0 +1,37 @@
1
+
2
+
3
+ # agent_lifecycle_and_heartbeat
4
+
5
+ Purpose
6
+ - Define the session lifecycle and handoff habits for this repo.
7
+
8
+ Story steps
9
+ 1) Establish session identity
10
+ - Use the agent identity provided by the user.
11
+ - If identity is missing or unclear, stop and ask before any work.
12
+ 2) Check-in
13
+ - Acknowledge scope, constraints, and ticket status.
14
+ - Ensure `attention_board.md` reflects active routing and open the linked active ticket.
15
+ 3) Work loop
16
+ - Use `tickets/epics/`, `tickets/stories/`, and `tickets/tasks/` for planning and execution.
17
+ - Keep ticket checklists current and append findings as they occur in `## Notes`.
18
+ 4) Check-out
19
+ - Summarize what changed, what remains, and what to do next.
20
+ - Move completed tickets to their matching completed folder
21
+ (`tickets/epics/completed/`, `tickets/stories/completed/`, `tickets/tasks/completed/`) only after user confirmation.
22
+
23
+ Artifacts touched
24
+ - `attention_board.md`
25
+ - `tickets/epics/`
26
+ - `tickets/epics/completed/`
27
+ - `tickets/stories/`
28
+ - `tickets/stories/completed/`
29
+ - `tickets/tasks/`
30
+ - `tickets/tasks/completed/`
31
+
32
+ References
33
+ - `agent_onboarding/default/general/skills/agent_lifecycle.md`
34
+ - `AGENTS.MD`
35
+
36
+
37
+
@@ -0,0 +1,41 @@
1
+
2
+
3
+ # onboarding_summary
4
+
5
+ Purpose
6
+ - Provide a concise onboarding checklist for agents.
7
+
8
+ Checklist (short form)
9
+ 1) Confirm repo root + policy sources
10
+ - Read `AGENTS.MD` and any directory-local `AGENTS.MD` in scope.
11
+ 2) Read onboarding entrypoints
12
+ - `config/context_compass_config.yaml`
13
+ - `context_compass/SKILLS.MD`
14
+ 3) First-time user path only (`new` profile)
15
+ - Read `agent_onboarding/default/new/skills/first_time_profile_setup.md`
16
+ - Read `agent_onboarding/default/new/README.md`
17
+ 4) Select working role
18
+ - Read the registry table in `context_compass/SKILLS.MD` for the current
19
+ role list. Do not rely on a role list copied into any other document.
20
+ - Read `agent_onboarding/default/general/SKILLS.MD` first.
21
+ - Read the selected role `SKILLS.MD` chain after baseline, parent-first.
22
+ 5) Certification gate
23
+ - Request approval before any tool usage or edits.
24
+ - Approval must include the exact token `CERTIFY: APPROVED`.
25
+ 6) Post-cert work execution
26
+ - Use `tickets/epics/`, `tickets/stories/`, and `tickets/tasks/` for all
27
+ work.
28
+ - Route from `attention_board.md` and resume from linked ticket notes.
29
+ - Orient from `system_docs/src_architecture.md` plus the architecture and
30
+ component indexes, then descend: index -> slice -> the code. Slice
31
+ `src_components.md` and `src_graph.md` through their indexes whenever the
32
+ work needs them - your call, no permission required, and never whole.
33
+ - Keep `attention_board.md` current for routing and ticket notes current for
34
+ durable findings.
35
+
36
+ References
37
+ - `AGENTS.MD`
38
+ - `config/context_compass_config.yaml`
39
+ - `context_compass/SKILLS.MD`
40
+
41
+
@@ -0,0 +1,44 @@
1
+
2
+
3
+ # work_intake_and_execution
4
+
5
+ Purpose
6
+ - Define how we intake work and execute it using `tickets/epics/`, `tickets/stories/`, and `tickets/tasks/` tickets.
7
+
8
+ Story steps
9
+ 1) Capture intent
10
+ - Restate the goal, constraints, and scope.
11
+ - If unclear, ask before writing tickets.
12
+ 2) Create tickets
13
+ - Use `templates/` to create epic/story/task tickets.
14
+ - Keep tickets deep and descriptive for handoff durability.
15
+ 3) Confirm before edits
16
+ - Share the plan and files to touch.
17
+ - Wait for explicit approval before edits.
18
+ 4) Execute
19
+ - Follow ticket steps and update checklists as work progresses.
20
+ - Run the Ticket Microcycle and document each meaningful finding before continuing investigation.
21
+ - Keep changes scoped and reviewable.
22
+ 5) Close out
23
+ - Walk through what was delivered.
24
+ - Ask if acceptance criteria are met.
25
+ - Move tickets to their matching completed folder (`tickets/epics/completed/`,
26
+ `tickets/stories/completed/`, `tickets/tasks/completed/`) only after explicit confirmation.
27
+
28
+ Artifacts touched
29
+ - `templates/`
30
+ - `tickets/epics/`
31
+ - `tickets/epics/completed/`
32
+ - `tickets/stories/`
33
+ - `tickets/stories/completed/`
34
+ - `tickets/tasks/`
35
+ - `tickets/tasks/completed/`
36
+
37
+ References
38
+ - `SKILLS.MD`
39
+ - `agent_onboarding/default/general/skills/workflow.md`
40
+
41
+
42
+
43
+
44
+