contextcompass 2.15.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- contextcompass-2.15.0.dist-info/METADATA +673 -0
- contextcompass-2.15.0.dist-info/RECORD +452 -0
- contextcompass-2.15.0.dist-info/WHEEL +4 -0
- contextcompass-2.15.0.dist-info/entry_points.txt +2 -0
- contextcompass-2.15.0.dist-info/licenses/LICENSE +21 -0
- contextcompass_cli/__init__.py +74 -0
- contextcompass_cli/__main__.py +195 -0
- contextcompass_cli/_package/AGENTS.MD +310 -0
- contextcompass_cli/_package/CONTEXT_COMPACTION.md +110 -0
- contextcompass_cli/_package/MANIFEST.md +485 -0
- contextcompass_cli/_package/PROFILE_CLASS_CREATION_GUIDE.md +426 -0
- contextcompass_cli/_package/README.md +266 -0
- contextcompass_cli/_package/SKILLS.MD +144 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/AGENTS.MD +54 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/README.md +43 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/behavioral_guidelines/continuity_fact_checker_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/examples/continuity_fact_checker_task_flow.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/policies/continuity_fact_checker_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/policies/continuity_fact_checker_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker.md +37 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_deliverables.md +26 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/continuity_fact_checker/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/AGENTS.MD +85 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/README.md +62 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/SKILLS.MD +74 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/behavioral_guidelines/design_engineer_workflow.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/behavioral_guidelines/design_validation_and_handoff.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/examples/adr_example.md +40 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/examples/design_task_flow.md +33 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/decision_record_policy.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/design_quality_policy.md +30 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/design_review_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/policies/system_document_quality_rubric.md +236 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/adr_and_decision_hygiene.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/api_and_interface_design.md +36 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_contexts.md +40 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_patch_contracts.md +43 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/architecture_tradeoffs.md +33 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/code_description_patch_contracts.md +46 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/component_patch_contracts.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/data_modeling.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/decomposition_and_boundaries.md +42 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/design_engineer_execution.md +65 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/design_review_protocol.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/nonfunctional_requirements.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/patch_framework_design.md +79 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/requirements_to_architecture.md +39 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/src_architecture_instructions.md +347 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/src_components_instructions.md +405 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/system_design_method.md +45 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/tests_architecture_instructions.md +375 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/skills/tests_components_instructions.md +406 -0
- contextcompass_cli/_package/agent_onboarding/default/design_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/AGENTS.MD +53 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/README.md +42 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/behavioral_guidelines/developmental_editor_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/examples/developmental_editor_task_flow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/policies/developmental_editor_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/policies/developmental_editor_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor.md +36 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_deliverables.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/skills/developmental_editor_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/developmental_editor/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/AGENTS.MD +54 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/README.md +43 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/behavioral_guidelines/draft_writer_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/examples/draft_writer_task_flow.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/policies/draft_writer_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/policies/draft_writer_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer.md +37 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_deliverables.md +26 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/skills/draft_writer_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/draft_writer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/AGENTS.MD +493 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/README.md +53 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/SKILLS.MD +263 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/behavioral_guidelines/engineer_workflow.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/behavioral_guidelines/task_execution_and_validation.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/examples/artifact_workflow.md +104 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/examples/eng_task_flow.md +30 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/policies/ctx_autonomy_policy.md +34 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/policies/ctx_autonomy_rubric.md +161 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/policies/engineer_quality_policy.md +33 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/context_protocol.md +70 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/documentation_standards.md +120 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/engineer_execution.md +62 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/package_maintenance.md +195 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/patch_artifact_consumption.md +68 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/patch_framework_gating.md +72 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/src_graph_generation.md +341 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/src_graph_usage.md +161 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/staleness_protocol.md +49 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/system_document_build.md +360 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/system_orientation.md +83 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/skills/technical_expertise.md +48 -0
- contextcompass_cli/_package/agent_onboarding/default/engineer/workflows/README.md +9 -0
- contextcompass_cli/_package/agent_onboarding/default/general/AGENTS.MD +283 -0
- contextcompass_cli/_package/agent_onboarding/default/general/README.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/general/SKILLS.MD +92 -0
- contextcompass_cli/_package/agent_onboarding/default/general/WORKFLOWS.MD +23 -0
- contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/README.md +12 -0
- contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/agent_lifecycle_and_heartbeat.md +37 -0
- contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/onboarding_summary.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/general/behavioral_guidelines/work_intake_and_execution.md +44 -0
- contextcompass_cli/_package/agent_onboarding/default/general/policies/policy_skills.md +174 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/active_documentation.md +86 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/active_pointerboard.md +81 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_identity.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_lifecycle.md +21 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/agent_stance.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/career_selection.md +83 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/compaction_requirements.md +147 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/configuration_standards.md +72 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/context_compaction.md +104 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/context_gold.md +31 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/context_management.md +79 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/context_window_budget.md +64 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/execution_contract.md +234 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/general.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/llm_full_usage.md +111 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/mailbox_protocol.md +85 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/memory_management.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/mrp_policy.md +40 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/package_upgrade.md +135 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/reactive_documentation.md +105 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/repo_topology.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/role_local_workflows.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/security_and_secrets.md +46 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/self_certification.md +49 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/ticket_closure_attention_sync.md +57 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/ticket_microcycle.md +44 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/ticketing.md +175 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/ticketing_skill_contract.md +52 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/unknowns_gate_reference.md +66 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/user_approved_certification.md +32 -0
- contextcompass_cli/_package/agent_onboarding/default/general/skills/workflow.md +289 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/README.md +9 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/cleanup_context_compass.md +205 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/role_creation.md +39 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/start_context_compass_work.md +102 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/sync_attention_board.md +91 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/turn_in_selected_tickets.md +95 -0
- contextcompass_cli/_package/agent_onboarding/default/general/workflows/workflow_creation.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/AGENTS.MD +53 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/README.md +42 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/behavioral_guidelines/line_copy_editor_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/examples/line_copy_editor_task_flow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/policies/line_copy_editor_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/policies/line_copy_editor_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor.md +36 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_deliverables.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/skills/line_copy_editor_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/line_copy_editor/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/new/AGENTS.MD +79 -0
- contextcompass_cli/_package/agent_onboarding/default/new/README.md +54 -0
- contextcompass_cli/_package/agent_onboarding/default/new/SKILLS.MD +35 -0
- contextcompass_cli/_package/agent_onboarding/default/new/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/new/behavioral_guidelines/user_onboarding_flow.md +52 -0
- contextcompass_cli/_package/agent_onboarding/default/new/policies/new_onboarding_policy.md +59 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/configuration_map_guide.md +83 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/first_time_profile_setup.md +60 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/new.md +54 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/onboarding_completion_and_next_step.md +54 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/profile_model_explained.md +120 -0
- contextcompass_cli/_package/agent_onboarding/default/new/skills/system_overview_for_user.md +51 -0
- contextcompass_cli/_package/agent_onboarding/default/new/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/AGENTS.MD +63 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/README.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/SKILLS.MD +62 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/behavioral_guidelines/incident_workflow.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/behavioral_guidelines/platform_engineer_workflow.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/examples/platform_task_flow.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/operational_safety_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/platform_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/policies/production_change_management_policy.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/ci_cd_and_release.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/deployment_and_environments.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/incident_response_and_runbooks.md +35 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/infrastructure_as_code.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/observability_and_monitoring.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/performance_capacity_cost.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/platform_engineer_execution.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/skills/platform_security_basics.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/platform_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/AGENTS.MD +53 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/README.md +42 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/behavioral_guidelines/proofreader_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/examples/proofreader_task_flow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/policies/proofreader_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/policies/proofreader_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader.md +36 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_deliverables.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/skills/proofreader_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/proofreader/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/AGENTS.MD +58 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/README.md +41 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/SKILLS.MD +61 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/behavioral_guidelines/qa_workflow.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/behavioral_guidelines/release_signoff_workflow.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/examples/qa_task_flow.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/defect_severity_policy.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/quality_gate_policy.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/policies/test_evidence_policy.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/bug_triage_and_repro.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/qa_engineer_execution.md +29 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/quality_metrics.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/regression_and_release_quality.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_automation_practices.md +30 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_case_design.md +27 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_data_and_environments.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/skills/test_strategy_and_planning.md +31 -0
- contextcompass_cli/_package/agent_onboarding/default/qa_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/AGENTS.MD +55 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/README.md +44 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/behavioral_guidelines/researcher_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/examples/researcher_task_flow.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/policies/researcher_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/policies/researcher_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher.md +38 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_deliverables.md +27 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/skills/researcher_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/researcher/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/AGENTS.MD +55 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/README.md +43 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/SKILLS.MD +62 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/behavioral_guidelines/security_signoff_and_escalation.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/behavioral_guidelines/security_workflow.md +18 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/examples/security_review_flow.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/risk_acceptance_policy.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/secrets_and_keys_policy.md +19 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/policies/security_review_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/authn_authz_basics.md +24 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/dependency_and_supply_chain.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/incident_response_security.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/logging_audit_privacy.md +16 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/secure_architecture_review.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/secure_coding_review.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/security_engineer_execution.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/threat_modeling.md +25 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/skills/vulnerability_management.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/security_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/AGENTS.MD +56 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/README.md +45 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/behavioral_guidelines/story_designer_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/examples/story_designer_task_flow.md +26 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/policies/story_designer_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/policies/story_designer_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer.md +39 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_deliverables.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/skills/story_designer_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/story_designer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/AGENTS.MD +56 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/README.md +45 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/behavioral_guidelines/story_novel_artist_workflow.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/examples/story_novel_artist_task_flow.md +26 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/policies/story_novel_artist_handoff_policy.md +20 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/policies/story_novel_artist_quality_policy.md +22 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist.md +39 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_advanced_context.md +17 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_deliverables.md +28 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/skills/story_novel_artist_execution.md +23 -0
- contextcompass_cli/_package/agent_onboarding/default/story_novel_artist/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/AGENTS.MD +66 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/SKILLS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/WORKFLOWS.MD +15 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/behavioral_guidelines/data_engineer_behavior_overrides.md +6 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/policies/data_engineer_policy_overrides.md +6 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/profile_overrides.md +9 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/skills/data_engineer_skill_overrides.md +6 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/data_engineer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/AGENTS.MD +145 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/SKILLS.MD +37 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/WORKFLOWS.MD +17 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/behavioral_guidelines/synaptic_finishing_developer_behavior_overrides.md +12 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/comment_finishing_examples.py +65 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/docstring_finishing_examples.py +126 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_component_finishing_examples.py +51 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_integration_finishing_examples.py +59 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_unit_finishing_examples.py +66 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/policies/synaptic_finishing_developer_policy_overrides.md +14 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/profile_overrides.md +17 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/comment_craft.md +51 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/docstring_craft.md +86 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/docstring_test_alignment.md +51 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/system_aware_docstrings.md +64 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/synaptic_finishing_developer_skill_overrides.md +11 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/component_tests.md +45 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/evidence_reporting.md +25 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/mocking.md +35 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/pytest_integration.md +32 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/pytest_unit.md +49 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/regression_tests.md +24 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/skills/testing/testing_overview.md +71 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/optimize_pytests_for_repo.md +272 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_finishing_developer/workflows/polish_repo_documentation.md +247 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/AGENTS.MD +386 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/README.md +31 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/SKILLS.MD +44 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/WORKFLOWS.MD +16 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/behavioral_guidelines/synaptic_behavior_overrides.md +17 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/anti_patterns.py +19 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/cleanup_patterns.py +22 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/docstrings.py +19 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/logging_patterns.py +11 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/protocols_and_abc.py +15 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_component_examples.py +15 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_integration_examples.py +17 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/examples/python/pytest_unit_examples.py +13 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/policies/synaptic_policy_overrides.md +22 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/profile_overrides.md +27 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/attribute_aliasing_skill_benchmark.py +35 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/banned_patterns.md +110 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/cleanup_and_disposal.md +79 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/comments.md +39 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/docstrings.md +90 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/error_model.md +28 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/hot_path_attribute_aliasing.md +52 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/init_and_ownership.md +35 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/interfaces.md +47 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/logging.md +37 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/module_scope.md +38 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/refactor_limits.md +44 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/python/typing.md +52 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/synaptic_skill_overrides.md +24 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/evidence_reporting.md +35 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/mocking.md +31 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/pytest_integration.md +36 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/pytest_unit.md +42 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/regression_tests.md +26 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/skills/testing/testing_overview.md +196 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/workflows/README.md +8 -0
- contextcompass_cli/_package/agent_onboarding/user_defined/synaptic_python_developer/workflows/synaptic_python_developer_onboarding.md +226 -0
- contextcompass_cli/_package/artifact_board.md +64 -0
- contextcompass_cli/_package/artifacts/IMPORTANT_CONSIDERATION.md +43 -0
- contextcompass_cli/_package/artifacts/README.md +41 -0
- contextcompass_cli/_package/attention_board.md +79 -0
- contextcompass_cli/_package/config/context_compass_config.yaml +101 -0
- contextcompass_cli/_package/context_management/README.md +21 -0
- contextcompass_cli/_package/context_management/artifacts/.gitkeep +1 -0
- contextcompass_cli/_package/context_management/context_artifact_template.md +42 -0
- contextcompass_cli/_package/context_management/context_board.md +27 -0
- contextcompass_cli/_package/examples/adr_example.md +29 -0
- contextcompass_cli/_package/examples/artifact_workflow.md +20 -0
- contextcompass_cli/_package/examples/continuity_fact_checker_task_flow.md +23 -0
- contextcompass_cli/_package/examples/design_task_flow.md +35 -0
- contextcompass_cli/_package/examples/developmental_editor_task_flow.md +22 -0
- contextcompass_cli/_package/examples/draft_writer_task_flow.md +23 -0
- contextcompass_cli/_package/examples/eng_task_flow.md +31 -0
- contextcompass_cli/_package/examples/example_architecture/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_architecture/src_architecture.md +136 -0
- contextcompass_cli/_package/examples/example_architecture/src_architecture_index.md +46 -0
- contextcompass_cli/_package/examples/example_architecture/tests_architecture.md +148 -0
- contextcompass_cli/_package/examples/example_architecture/tests_architecture_index.md +46 -0
- contextcompass_cli/_package/examples/example_completed/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_completed/2026-02-19_context_compass_release_overview_artifact.md +33 -0
- contextcompass_cli/_package/examples/example_components/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_components/src_components.md +169 -0
- contextcompass_cli/_package/examples/example_components/src_components_index.md +44 -0
- contextcompass_cli/_package/examples/example_components/tests_components.md +96 -0
- contextcompass_cli/_package/examples/example_components/tests_components_index.md +42 -0
- contextcompass_cli/_package/examples/example_epics/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_epics/2026-02-19_context_compass_release_readiness_example_pack_epic.md +130 -0
- contextcompass_cli/_package/examples/example_graph_details/README.md +131 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/__init__.py +4 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/core/interfaces.py +10 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/core/resource.py +15 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/pipeline/pipeline.py +20 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/pipeline/stage.py +11 -0
- contextcompass_cli/_package/examples/example_graph_details/src/example/storage/store.py +20 -0
- contextcompass_cli/_package/examples/example_graph_details/src_graph.md +192 -0
- contextcompass_cli/_package/examples/example_graph_details/src_graph_index.md +32 -0
- contextcompass_cli/_package/examples/example_stories/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_stories/2026-02-19_context_compass_release_readiness_examples_story.md +120 -0
- contextcompass_cli/_package/examples/example_tasks/.gitkeep +0 -0
- contextcompass_cli/_package/examples/example_tasks/2026-02-19_context_compass_release_readiness_pack_task.md +147 -0
- contextcompass_cli/_package/examples/line_copy_editor_task_flow.md +23 -0
- contextcompass_cli/_package/examples/platform_task_flow.md +26 -0
- contextcompass_cli/_package/examples/proofreader_task_flow.md +23 -0
- contextcompass_cli/_package/examples/qa_task_flow.md +26 -0
- contextcompass_cli/_package/examples/repo_overview.md +63 -0
- contextcompass_cli/_package/examples/researcher_task_flow.md +23 -0
- contextcompass_cli/_package/examples/security_review_flow.md +24 -0
- contextcompass_cli/_package/examples/story_designer_task_flow.md +23 -0
- contextcompass_cli/_package/examples/story_novel_artist_task_flow.md +22 -0
- contextcompass_cli/_package/mailbox_board.md +79 -0
- contextcompass_cli/_package/special_instructions/README.md +16 -0
- contextcompass_cli/_package/system_docs/.gitkeep +0 -0
- contextcompass_cli/_package/system_docs/patches/active/README.md +25 -0
- contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/architecture_patch.md +53 -0
- contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/code_description_patch_TEMPLATE_COMPONENT.md +39 -0
- contextcompass_cli/_package/system_docs/patches/active/_template_patch_id/component_patch_TEMPLATE_COMPONENT.md +48 -0
- contextcompass_cli/_package/system_docs/system_docs_read_first.md +107 -0
- contextcompass_cli/_package/templates/epic_template.md +149 -0
- contextcompass_cli/_package/templates/story_template.md +131 -0
- contextcompass_cli/_package/templates/task_template.md +124 -0
- contextcompass_cli/_package/templates/workflow_advanced_template.md +111 -0
- contextcompass_cli/_package/templates/workflow_simple_template.md +65 -0
- contextcompass_cli/_package/tickets/README.md +24 -0
- contextcompass_cli/_package/tickets/epics/README.md +68 -0
- contextcompass_cli/_package/tickets/epics/archive/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/epics/backlog/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/epics/completed/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/stories/README.md +68 -0
- contextcompass_cli/_package/tickets/stories/archive/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/stories/backlog/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/stories/completed/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/tasks/README.md +67 -0
- contextcompass_cli/_package/tickets/tasks/archive/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/tasks/backlog/.gitkeep +0 -0
- contextcompass_cli/_package/tickets/tasks/completed/.gitkeep +0 -0
- contextcompass_cli/_package/tools/build_llm_full.py +307 -0
- contextcompass_cli/_package/tools/cleanup_context_compass.py +488 -0
- contextcompass_cli/_package/tools/migrate_boards.py +218 -0
- contextcompass_cli/_package/tools/package_manifest.py +351 -0
- contextcompass_cli/_package/tools/system_documents/index_document.py +476 -0
- contextcompass_cli/_package/tools/system_documents/python/assemble_graph.py +387 -0
- contextcompass_cli/_package/tools/system_documents/python/extract_graph.py +626 -0
- contextcompass_cli/_package/tools/system_documents/python/graph_semantics_tickets.py +405 -0
- contextcompass_cli/_package/tools/system_documents/python/graph_walker.py +375 -0
- contextcompass_cli/_package/tools/system_documents/python/migrate_authored_graph.py +179 -0
- contextcompass_cli/_package/tools/update_context_compass.py +511 -0
- contextcompass_cli/_package/user_defined/README.md +49 -0
|
@@ -0,0 +1,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
|
+
|