contextcompass 2.19.3__tar.gz → 2.21.0__tar.gz

contextcompass-2.19.3/README.md → contextcompass-2.21.0/PKG-INFO

@@ -1,3 +1,26 @@
+Metadata-Version: 2.5
+Name: contextcompass
+Version: 2.21.0
+Summary: Durable, file-backed execution state for coding agents.
+Project-URL: Homepage, https://github.com/Synaptic724/context_compass
+Project-URL: Repository, https://github.com/Synaptic724/context_compass
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: agents,context,documentation,handoff,llm,tickets
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Documentation
+Requires-Python: >=3.10
+Provides-Extra: tokens
+Requires-Dist: tiktoken<1,>=0.12; extra == 'tokens'
+Description-Content-Type: text/markdown
+
 # Context Compass™
 
 [![PyPI](https://img.shields.io/pypi/v/contextcompass.svg)](https://pypi.org/project/contextcompass/)
@@ -119,9 +142,9 @@ commit, or modify the package before adopting it.
 ### What actually needs Python
 
 Only `tools/` — the scripts that build the manifest, index documents, generate the
-source graph, and upgrade an install. **Python 3.10+, stdlib only, no dependencies
-ever.** An agent that has to `pip install` before it can read a document is an
-agent that cannot read the document on a fresh clone.
+source graph, and upgrade an install. Those tools use **Python 3.10+ and the
+standard library**. The optional token-report tool uses `tiktoken`; reading the
+documents and ordinary installation do not require it.
 
 The release workflow runs the suite on Python 3.10 through 3.14 on Linux and
 Windows. Verify an install any time:
@@ -265,10 +288,19 @@ heading declares which:
 
 | state | required to certify? | when it is read |
 | --- | --- | --- |
-| **baseline** | yes | at onboarding, every time |
-| **On-demand** | no | only when the section's stated trigger fires |
+| **baseline** (eager) | yes | at onboarding and recovery, every time |
+| **On-demand** (lazy) | no | only when the entry's stated trigger fires |
 | **Self-directed** | no | at the agent's initiative — no trigger, no permission |
 
+The eager readset is kept to what every session needs: policy, identity, the
+ticket loop and the active board. Procedures such as upgrades, cleanup, batch
+turn-in, system-document authoring and setup forms sit in a lazy index instead:
+one entry per file, each saying what it covers and which request or action loads
+it. The agent holds the index from onboarding and reads a file in full only when
+its trigger fires. Set `reading.mode: full` in the config to read the lazy entries
+up front as well; the default is `lean`. Run `contextcompass token-report` to see
+what each role reads eagerly and what it can load later.
+
 The third state exists because collapsing it into On-demand produces a specific
 failure: an agent finds no trigger has fired, reads none of the system documents,
 and reasons from class names instead — with sound-looking justification. Waiting
@@ -590,6 +622,23 @@ All under `context_compass/tools/`, all stdlib-only, all `--check` before `--app
 | `system_documents/python/graph_semantics_tickets.py` | turn unauthored areas into tickets |
 | `system_documents/python/migrate_authored_graph.py` | carry a graph out of the retired JSON format |
 
+## See What Onboarding Loads
+
+Want to know where the context goes? The optional token report counts each file
+and compares every registered role, inherited skill chain, ticket backend and
+message transport. It also shows which reads are conditional, which are partial,
+and what the tool cannot determine automatically.
+
+```sh
+python -m pip install "contextcompass[tokens]"
+contextcompass token-report --role engineer --out-dir context_compass_report
+```
+
+The report does not change your settings or tell an agent to skip instructions.
+It measures source text, not total chat usage or billing. See the
+[reporting guide](src/context_compass/tools/TOKEN_REPORT.md) for direct Python
+usage, route comparisons, output formats and privacy limits.
+
 ## Feed The Whole System To A Model
 
 Sometimes you want a model to see everything at once — reviewing a change to the

contextcompass-2.19.3/PKG-INFO → contextcompass-2.21.0/README.md

@@ -1,24 +1,3 @@
-Metadata-Version: 2.5
-Name: contextcompass
-Version: 2.19.3
-Summary: Durable, file-backed execution state for coding agents.
-Project-URL: Homepage, https://github.com/Synaptic724/context_compass
-Project-URL: Repository, https://github.com/Synaptic724/context_compass
-License-Expression: Apache-2.0
-License-File: LICENSE
-License-File: NOTICE
-Keywords: agents,context,documentation,handoff,llm,tickets
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Software Development :: Documentation
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-
 # Context Compass™
 
 [![PyPI](https://img.shields.io/pypi/v/contextcompass.svg)](https://pypi.org/project/contextcompass/)
@@ -140,9 +119,9 @@ commit, or modify the package before adopting it.
 ### What actually needs Python
 
 Only `tools/` — the scripts that build the manifest, index documents, generate the
-source graph, and upgrade an install. **Python 3.10+, stdlib only, no dependencies
-ever.** An agent that has to `pip install` before it can read a document is an
-agent that cannot read the document on a fresh clone.
+source graph, and upgrade an install. Those tools use **Python 3.10+ and the
+standard library**. The optional token-report tool uses `tiktoken`; reading the
+documents and ordinary installation do not require it.
 
 The release workflow runs the suite on Python 3.10 through 3.14 on Linux and
 Windows. Verify an install any time:
@@ -286,10 +265,19 @@ heading declares which:
 
 | state | required to certify? | when it is read |
 | --- | --- | --- |
-| **baseline** | yes | at onboarding, every time |
-| **On-demand** | no | only when the section's stated trigger fires |
+| **baseline** (eager) | yes | at onboarding and recovery, every time |
+| **On-demand** (lazy) | no | only when the entry's stated trigger fires |
 | **Self-directed** | no | at the agent's initiative — no trigger, no permission |
 
+The eager readset is kept to what every session needs: policy, identity, the
+ticket loop and the active board. Procedures such as upgrades, cleanup, batch
+turn-in, system-document authoring and setup forms sit in a lazy index instead:
+one entry per file, each saying what it covers and which request or action loads
+it. The agent holds the index from onboarding and reads a file in full only when
+its trigger fires. Set `reading.mode: full` in the config to read the lazy entries
+up front as well; the default is `lean`. Run `contextcompass token-report` to see
+what each role reads eagerly and what it can load later.
+
 The third state exists because collapsing it into On-demand produces a specific
 failure: an agent finds no trigger has fired, reads none of the system documents,
 and reasons from class names instead — with sound-looking justification. Waiting
@@ -611,6 +599,23 @@ All under `context_compass/tools/`, all stdlib-only, all `--check` before `--app
 | `system_documents/python/graph_semantics_tickets.py` | turn unauthored areas into tickets |
 | `system_documents/python/migrate_authored_graph.py` | carry a graph out of the retired JSON format |
 
+## See What Onboarding Loads
+
+Want to know where the context goes? The optional token report counts each file
+and compares every registered role, inherited skill chain, ticket backend and
+message transport. It also shows which reads are conditional, which are partial,
+and what the tool cannot determine automatically.
+
+```sh
+python -m pip install "contextcompass[tokens]"
+contextcompass token-report --role engineer --out-dir context_compass_report
+```
+
+The report does not change your settings or tell an agent to skip instructions.
+It measures source text, not total chat usage or billing. See the
+[reporting guide](src/context_compass/tools/TOKEN_REPORT.md) for direct Python
+usage, route comparisons, output formats and privacy limits.
+
 ## Feed The Whole System To A Model
 
 Sometimes you want a model to see everything at once — reviewing a change to the

{contextcompass-2.19.3 → contextcompass-2.21.0}/contributor/testing.md

@@ -2,8 +2,9 @@
 
 ## Set Up Locally
 
-The shipped tools use the standard library and support Python 3.10 and newer.
-Development uses pytest, declared in the `dev` dependency group. From the root:
+Base tools use the standard library and support Python 3.10 and newer. Optional
+token reporting uses tiktoken. Development includes pytest and that tokenizer
+in the `dev` dependency group so real counting tests run. From the root:
 
 ```sh
 uv sync --group dev
@@ -47,6 +48,7 @@ These are entry points, not separate release gates:
 | Graph extraction and authored-data preservation | `tests/integration/test_authoring_lifecycle.py`, `tests/integration/test_graph_pipeline.py`, `tests/unit/test_graph_units.py` |
 | Graph-generated tickets | `tests/integration/test_semantics_tickets.py` |
 | Document indexes and review dumps | `tests/integration/test_index_lifecycle.py`, `tests/integration/test_llm_full.py`, `tests/unit/test_index_units.py` |
+| Token counts and reading-route reports | `tests/unit/test_token_report.py`, `tests/integration/test_token_report_cli.py` |
 | Previously reported failures | `tests/regression/test_known_failures.py` |
 
 For example:

{contextcompass-2.19.3 → contextcompass-2.21.0}/pyproject.toml

@@ -18,11 +18,13 @@ classifiers = [
     "Topic :: Software Development :: Documentation",
 ]
 
-# The payload is Markdown and stdlib-only Python. An agent that has to install
-# something before it can read a document is an agent that cannot read the
-# document on a fresh clone.
+# Reading the payload and ordinary CLI commands need no dependencies. Token
+# reporting is an optional tool; it must not become an onboarding prerequisite.
 dependencies = []
 
+[project.optional-dependencies]
+tokens = ["tiktoken>=0.12,<1"]
+
 [project.urls]
 Homepage = "https://github.com/Synaptic724/context_compass"
 Repository = "https://github.com/Synaptic724/context_compass"
@@ -31,7 +33,7 @@ Repository = "https://github.com/Synaptic724/context_compass"
 contextcompass = "contextcompass_cli.__main__:main"
 
 [dependency-groups]
-dev = ["pytest>=8"]
+dev = ["pytest>=8", "tiktoken>=0.12,<1"]
 
 [build-system]
 requires = ["hatchling"]

{contextcompass-2.19.3 → contextcompass-2.21.0}/src/context_compass/AGENTS.MD

@@ -230,6 +230,7 @@ After any context compaction or handoff, apply the bootstrap before these recove
   `agent_onboarding/default/general/skills/work_tracking_backend.md` and message
   transport with `agent_onboarding/default/general/skills/agent_communication_backend.md`,
   then read `SKILLS.MD`. Count each selector read once in the general baseline.
+  Resolve `reading.mode` from the same file; missing means `lean`.
 - Project rules resolved in the bootstrap above stay resolved; later MUST
   statements restate defaults and do not reinstate an overridden requirement.
   Use relative repo paths only.
@@ -334,6 +335,10 @@ Before any tooling, edits, or execution:
     them, without asking permission.
   - **Do not treat Self-directed as On-demand-with-no-trigger-yet.** That reading
     produces an agent that never opens the document, and it has already happened.
+- Resolve `reading.mode` from `config/context_compass_config.yaml`; missing means
+  `lean`. In `lean`, On-demand entries are the lazy readset: read each one in full
+  when its trigger fires. In `full`, also read every On-demand entry in the
+  resolved chain at onboarding and recovery, as if it were baseline.
 - If first-time onboarding is active and selected role is `new`, complete the
   effective onboarding requirements and the first authorized check-in before setting:
   - `profiles.onboarding.first_time_enabled: false`

{contextcompass-2.19.3 → contextcompass-2.21.0}/src/context_compass/MANIFEST.md

@@ -6,8 +6,8 @@ from the files themselves, which is the only reason it can be trusted.
 | field | value |
 | --- | --- |
 | manifest_version | 1.0.0 |
-| package_version | 2.19.3 |
-| files | 465 |
+| package_version | 2.21.0 |
+| files | 470 |
 
 ## Lane policy
 
@@ -29,7 +29,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 
 | class | files | cleanup | update |
 | --- | --- | --- | --- |
-| PACKAGE | 362 | restore | replace |
+| PACKAGE | 367 | restore | replace |
 | RESET | 26 | keep listed, remove unlisted | leave alone |
 | INSTANCE | 72 | never touched | never touched |
 | LIVE | 4 | reset managed block | swap managed block |
@@ -40,21 +40,21 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | path | class | sha256 |
 | --- | --- | --- |
 | `.gitattributes` | PACKAGE | `9ff348d31ff5f0941a76321a0ef45d47acb5bd218c3febffd3885f453ea325ef` |
-| `AGENTS.MD` | PACKAGE | `4666e7ca0151711cd49a08d6ac11d455916855846510d012b812da24c3b11adb` |
+| `AGENTS.MD` | PACKAGE | `53c2d73d640475ab55bb0ce8c16c6e11701a3e5f56c0a23b04733f1ead918647` |
 | `agent_onboarding/default/continuity_fact_checker/AGENTS.MD` | PACKAGE | `3928c7c3959d7c75e0b3752cce505119060bed73b4ad565923d4801cfa703557` |
 | `agent_onboarding/default/continuity_fact_checker/behavioral_guidelines/continuity_fact_checker_workflow.md` | PACKAGE | `ace3e5e300fda18719730e05bdb0ca15d8afdc32289e1a13a7c8bd3d91470753` |
 | `agent_onboarding/default/continuity_fact_checker/examples/continuity_fact_checker_task_flow.md` | PACKAGE | `97303ea953c81565410b611848b42b4ec84f73d6351ae2754111c7bd2dd4e4aa` |
 | `agent_onboarding/default/continuity_fact_checker/policies/continuity_fact_checker_handoff_policy.md` | PACKAGE | `4d13b91836c1a27623471204baf731c18fc9c135877c0ffde35dd9b7f2715c53` |
 | `agent_onboarding/default/continuity_fact_checker/policies/continuity_fact_checker_quality_policy.md` | PACKAGE | `a015e71de7d00dc8695dbfb3cf7ad13c43a7b9b15ef1a285e570060e5f3d67a5` |
 | `agent_onboarding/default/continuity_fact_checker/README.md` | PACKAGE | `ac048e655aaf4dc7e04a28216b4878f5b3fa8542fcc001dc433e4585a1d0663a` |
-| `agent_onboarding/default/continuity_fact_checker/SKILLS.MD` | PACKAGE | `f59516223a8575982b222392bd33d53c1ff6571891f2c81bc58d8ad1c804b1cb` |
+| `agent_onboarding/default/continuity_fact_checker/SKILLS.MD` | PACKAGE | `13cc6c843193fe134f4620e0a92cbf6458a3d127ce4a5d3fab4b4c860f00714f` |
 | `agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker.md` | PACKAGE | `5d05783c89bb78540957b461eca5ddd119d5827507852dba5c93fe8391e4fcab` |
 | `agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_advanced_context.md` | PACKAGE | `46a0cd3ca1cbfa1f57224fa3580bbe08ddb957a30f99c33730bcf08d2f2ecc9c` |
 | `agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_deliverables.md` | PACKAGE | `faa0a9ba50e604c5d7c790890081a516331153968d271a9c6c37a78048d87d89` |
 | `agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_execution.md` | PACKAGE | `e3a8b282a88365a798c931f64cc08f07df8f0a7df9855ba4d48c488edd17e6be` |
 | `agent_onboarding/default/continuity_fact_checker/WORKFLOWS.MD` | PACKAGE | `9d5e6c74c08fe5a32f820ec74a5f06790d0eadffb37fbc17d2ea386bee7cc1a4` |
 | `agent_onboarding/default/continuity_fact_checker/workflows/README.md` | PACKAGE | `00cd0ec7d92738102ad5e3a9396a130e240c607652510085640001b5302a57b4` |
-| `agent_onboarding/default/design_engineer/AGENTS.MD` | PACKAGE | `18bbd6d1ea1249650e0ceb53bb4ce563b46cce2178c7f32f52cc33d65239a05e` |
+| `agent_onboarding/default/design_engineer/AGENTS.MD` | PACKAGE | `16cbd2ed3f421e38cc74b12356aa6747a345224d98045525cea530d2a43e6a73` |
 | `agent_onboarding/default/design_engineer/behavioral_guidelines/design_engineer_workflow.md` | PACKAGE | `6024396b89a1d285a8c508ef0a1f718b731d34b14a2c97412c9e06f42d3bae90` |
 | `agent_onboarding/default/design_engineer/behavioral_guidelines/design_validation_and_handoff.md` | PACKAGE | `a23db689d0a7bba6cc2848d3f63ac052e9bd10a4596a7361a7cb84053de16e13` |
 | `agent_onboarding/default/design_engineer/examples/adr_example.md` | PACKAGE | `0af9273423b5300f917041439a03ab8407894d15e16bb7412b032b9952d70996` |
@@ -64,7 +64,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/design_engineer/policies/design_review_policy.md` | PACKAGE | `5f2909838104b47a4296dd611077cac7a2224c3eeb8f45dea865b676c2dd575a` |
 | `agent_onboarding/default/design_engineer/policies/system_document_quality_rubric.md` | PACKAGE | `5ff496833cae8ce5b7a8273535ae855a8a24ff5fb313a96931dcc643962f0f4c` |
 | `agent_onboarding/default/design_engineer/README.md` | PACKAGE | `d4a2fc9540810084b70808d8a0175243596cf1d449f9367d0ca065cf5f3c331d` |
-| `agent_onboarding/default/design_engineer/SKILLS.MD` | PACKAGE | `93d6661c77d96d6931065b0ddb748d07f5a6f45353816c9ecf82efa3aec58c27` |
+| `agent_onboarding/default/design_engineer/SKILLS.MD` | PACKAGE | `534118a447ed5b48ccf49b03f2149f8e9e37c6049c6b031ebf1544454786be43` |
 | `agent_onboarding/default/design_engineer/skills/adr_and_decision_hygiene.md` | PACKAGE | `2ae7193b75fcc0f784324c9a4a8870bc7c5636dc561f36436c40813d9cb38fad` |
 | `agent_onboarding/default/design_engineer/skills/api_and_interface_design.md` | PACKAGE | `8ba14c3a10040852b87f9a1023b400ee19275e8c616b2fbf9b667111d54fbf0e` |
 | `agent_onboarding/default/design_engineer/skills/architecture_contexts.md` | PACKAGE | `a2efbe330609582c3fb81303e46ff706b563907919a158800dbd55ec325d3d23` |
@@ -92,7 +92,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/developmental_editor/policies/developmental_editor_handoff_policy.md` | PACKAGE | `32140442c79e7b2a80aea68b5d975adb3248ed01304a529a721ce7f3c99814f9` |
 | `agent_onboarding/default/developmental_editor/policies/developmental_editor_quality_policy.md` | PACKAGE | `b5b2b4ca716b838150d06edd33aba88587e7a44351b0a7c7e3f5c4935c5d6334` |
 | `agent_onboarding/default/developmental_editor/README.md` | PACKAGE | `d9cee87ba47cd96163e5169fb0b6c4b73183b691f14b1d98b807682a5f2190f0` |
-| `agent_onboarding/default/developmental_editor/SKILLS.MD` | PACKAGE | `c653f3cd89cbe6fa8e119311e07a9ceb5601eee7beb41c39f09657889e377983` |
+| `agent_onboarding/default/developmental_editor/SKILLS.MD` | PACKAGE | `5f8f9ed4aa00d40597164b83a9e2624ffdfd500ff82414ade39d994faa7e5bf0` |
 | `agent_onboarding/default/developmental_editor/skills/developmental_editor.md` | PACKAGE | `5329e9fe05dadb5db0c13abff45a2b7cc5db547e4a9d490c60f8da644111f569` |
 | `agent_onboarding/default/developmental_editor/skills/developmental_editor_advanced_context.md` | PACKAGE | `d601fe5deca758b594b4e5ab93c60a5038bba0b19db603fc5653e1c0cfd6a7ba` |
 | `agent_onboarding/default/developmental_editor/skills/developmental_editor_deliverables.md` | PACKAGE | `b711d460c49fc13f2444037c7554f4626b4d4b0642776fa6fdf8fb982c27ce4c` |
@@ -105,14 +105,14 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/draft_writer/policies/draft_writer_handoff_policy.md` | PACKAGE | `8c095c14cbfbea2b1be71d81ca22c5d31d2401b131161ab425be6a8ac10f7f78` |
 | `agent_onboarding/default/draft_writer/policies/draft_writer_quality_policy.md` | PACKAGE | `a2fb5fb650756a8a5ecf251ae8f108247160c87c0d318c87233b186359bb9e49` |
 | `agent_onboarding/default/draft_writer/README.md` | PACKAGE | `b7c2f377db14ae63707e6131bb42d3c91a979b8a0daa4c0ae8287fa6f6793428` |
-| `agent_onboarding/default/draft_writer/SKILLS.MD` | PACKAGE | `00050b916093a965d16f7e86202cf46c421f730a8579d94a8ce04fa77973cfdf` |
+| `agent_onboarding/default/draft_writer/SKILLS.MD` | PACKAGE | `3092791f967e2e86ee2ce44b4e287de82662be97b8513bdc36958fb0dc0eb5b2` |
 | `agent_onboarding/default/draft_writer/skills/draft_writer.md` | PACKAGE | `8a8011fcc82d7f24f59a42f68f4ffc1decd08f0861654a53c6452540b5abc5cc` |
 | `agent_onboarding/default/draft_writer/skills/draft_writer_advanced_context.md` | PACKAGE | `6530f0bf57a1837104db096ed647e1d53a500daeb1e6ebbc0825d36d645fef1e` |
 | `agent_onboarding/default/draft_writer/skills/draft_writer_deliverables.md` | PACKAGE | `830313b7f9fe616ef09f8ccf89c364732a94082642ad28578fd955a2a9d71066` |
 | `agent_onboarding/default/draft_writer/skills/draft_writer_execution.md` | PACKAGE | `c2c32f82b91b0fb793b29421990bc6d0a4452f444531cd9741c931001e40e0e7` |
 | `agent_onboarding/default/draft_writer/WORKFLOWS.MD` | PACKAGE | `eb488174d9c52d130fac93715da91e8850d29aac9bbd84b1be3ff16a89df6621` |
 | `agent_onboarding/default/draft_writer/workflows/README.md` | PACKAGE | `c26b46d75cafb3bf5ae9d6e71d09490e6f18d58c0313bbf39fc0df85b8fe5801` |
-| `agent_onboarding/default/engineer/AGENTS.MD` | PACKAGE | `ad431350f713f0e3a6c084ae4fc71886eca6a985d77b169e369c3f44800485c6` |
+| `agent_onboarding/default/engineer/AGENTS.MD` | PACKAGE | `bdf2743ac29ea81e445ac7a3bbfcd46e15facc64139e6b27ed4dc92df3285372` |
 | `agent_onboarding/default/engineer/behavioral_guidelines/engineer_workflow.md` | PACKAGE | `591262fe58d4d832c678a466dd2692aa905df7711b451be57320a7b10baa9661` |
 | `agent_onboarding/default/engineer/behavioral_guidelines/task_execution_and_validation.md` | PACKAGE | `fa50dfc2d126f742ac0d99717314df1cd496f38c597ddca055296017cc1f7648` |
 | `agent_onboarding/default/engineer/examples/artifact_workflow.md` | PACKAGE | `c879058f7f61aa1d33f16f2276ccf792a6d835b2e5017098e776f2d9f0edf85b` |
@@ -121,7 +121,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/engineer/policies/ctx_autonomy_rubric.md` | PACKAGE | `71b306ab176626ff499afa56b06c8d689adc44ae100f095558b090bd4a07ae76` |
 | `agent_onboarding/default/engineer/policies/engineer_quality_policy.md` | PACKAGE | `fb747be91e0d8eb000791d54b9e4305cc3f08393ee75949a3a329f74fd89588c` |
 | `agent_onboarding/default/engineer/README.md` | PACKAGE | `733cd38fa33408b14f6da0fa78fce0bef964d128f28147080cae9eb192cb51c1` |
-| `agent_onboarding/default/engineer/SKILLS.MD` | PACKAGE | `e263d8b3b34bd18892f6de4480c5499cfb02e9936cde4264dafc83a4c1731776` |
+| `agent_onboarding/default/engineer/SKILLS.MD` | PACKAGE | `acfb65bf846bf9df52245738bd73a6d699bf75f0712201847ca179ad418d5800` |
 | `agent_onboarding/default/engineer/skills/context_protocol.md` | PACKAGE | `bdb8bc75935e9d48c429cb0082436a418bef8ab32526fd3ba796a912cd87423f` |
 | `agent_onboarding/default/engineer/skills/documentation_standards.md` | PACKAGE | `bdc4e7076c69789fcb3e701742e1bd4d82128cd1792697df38aa0fd3c3f1b711` |
 | `agent_onboarding/default/engineer/skills/engineer_execution.md` | PACKAGE | `37e08eb3e5067e2a548b71fbb626278bdceed2bf64f1894d9456044599a798c1` |
@@ -134,16 +134,17 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/engineer/skills/system_document_build.md` | PACKAGE | `b53ca5318f8d695929014ce745e7ff3ffd343a0fda2c23a7354fa87a14220c1e` |
 | `agent_onboarding/default/engineer/skills/system_orientation.md` | PACKAGE | `6791c2395ed9764a735bb51b403d2f0d15d13bfd195fa4f5c648d56b3c3c935a` |
 | `agent_onboarding/default/engineer/skills/technical_expertise.md` | PACKAGE | `07f2979c10673b405581017aab541790153b66424a3e75ea0a841a5f832b9adf` |
+| `agent_onboarding/default/engineer/skills/testing_discipline.md` | PACKAGE | `c07c2ecb962d2395527b3946c1bdc669610f6e7535eafa3befcae9d2f2472758` |
 | `agent_onboarding/default/engineer/WORKFLOWS.MD` | PACKAGE | `2804d7032d8a718304193ad9fc237e75537e3f778360703b34a3f0383d5c2599` |
 | `agent_onboarding/default/engineer/workflows/README.md` | PACKAGE | `b242a08fc1ff33ca4c63e300bfd89ebf72088169aa9b9afaed731bc5d14ec1b5` |
-| `agent_onboarding/default/general/AGENTS.MD` | PACKAGE | `f5007245f000c1e36e8d9e07e5f427dace97bc8f93a6fa673ace9dce6d39d0fa` |
+| `agent_onboarding/default/general/AGENTS.MD` | PACKAGE | `ee1344876de3df93ab05a61ea88937cb011660d41a2c4840443fc3202e159629` |
 | `agent_onboarding/default/general/behavioral_guidelines/agent_lifecycle_and_heartbeat.md` | PACKAGE | `f0f2bfa601181aae1d28faa082a35881703b8f383a1455c93853932dda7e78fd` |
 | `agent_onboarding/default/general/behavioral_guidelines/onboarding_summary.md` | PACKAGE | `f44f530b09b8bb2dce40891aee43ca7e0d0b07bcfc61f68e8e96c05aba71b5e9` |
 | `agent_onboarding/default/general/behavioral_guidelines/README.md` | PACKAGE | `4fc03023bb404a1cc141e818855797aece8c67ddd07ea3324fd042cf0ec71629` |
 | `agent_onboarding/default/general/behavioral_guidelines/work_intake_and_execution.md` | PACKAGE | `84b91a3e414e2c1d528be970604b8a950e16943e4ade7896efac7bca7ff3572b` |
 | `agent_onboarding/default/general/policies/policy_skills.md` | PACKAGE | `8bb02cbf1157ae9ad578fb4f000daf5a24d7276a05d3a945259d838b2e00f4d0` |
 | `agent_onboarding/default/general/README.md` | PACKAGE | `405ecd65632a0b05cf4d251f76c8ff135fdfb12fe6d460d6ea4d5082efda1cdc` |
-| `agent_onboarding/default/general/SKILLS.MD` | PACKAGE | `2303e4c9225e988bfb15d9541c979c69a498c54b8971a4fbfabac8bc3afd835b` |
+| `agent_onboarding/default/general/SKILLS.MD` | PACKAGE | `2f2f67f661e476b2c53d36431baa081efa4c4aa8b730db97bd6899fdb69b1f18` |
 | `agent_onboarding/default/general/skills/active_documentation.md` | PACKAGE | `e982fe2bacd1d4c403e423435bba7ef93afd91f3db3b01f19a1e5fab9edef060` |
 | `agent_onboarding/default/general/skills/active_pointerboard.md` | PACKAGE | `caceb81ace03dc804c38934d11fe7e324e47505c3006894344f1949da1f7bf7e` |
 | `agent_onboarding/default/general/skills/agent_communication_backend.md` | PACKAGE | `cbe8c2dffd6e9e9915f1601463e2bf8fb5805fbbf279ede5ea189e91393d3429` |
@@ -152,12 +153,12 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/general/skills/agent_session_state.md` | PACKAGE | `3124dbfdadb14cdf55a42790a16aafe7b926f6078cf3490e2b83affc50b68046` |
 | `agent_onboarding/default/general/skills/agent_stance.md` | PACKAGE | `6d259f4e79ff30b12af0914319b85206e13a273f4b741db2760f1a4447f48344` |
 | `agent_onboarding/default/general/skills/career_selection.md` | PACKAGE | `f6848776d7fdf1082f0b3da66cf781f0bede746b181c8006214106d718c153fe` |
-| `agent_onboarding/default/general/skills/codex_mcp.md` | PACKAGE | `8ef7f5975922bd59b438376ee21f0c7ce49fe9e4e9f13ce821d71d837dd02fb5` |
+| `agent_onboarding/default/general/skills/codex_mcp.md` | PACKAGE | `310707dafc126d4778ac0765e5789a29b249414eaff555ab7bc9bddb45208689` |
 | `agent_onboarding/default/general/skills/compaction_requirements.md` | PACKAGE | `ec65f1f98b0292b154e57ce1e379b950143320420701945631228853c2108506` |
 | `agent_onboarding/default/general/skills/configuration_standards.md` | PACKAGE | `abf610ca6633c14d309fe088dd1e6da793d7a8c8c2afd72b5a66c26a826b1276` |
 | `agent_onboarding/default/general/skills/context_compaction.md` | PACKAGE | `2d1b72abad44a3cbae80a06e61932fdcf3b5d780660b0b943de27106ec683889` |
 | `agent_onboarding/default/general/skills/context_gold.md` | PACKAGE | `1203682dbe6ed0311811b5034e8589a4eb3cf8a71b129ea76984ab89b3f3d0cc` |
-| `agent_onboarding/default/general/skills/context_management.md` | PACKAGE | `cfc9f0cf1873720130714e331259b443ec7031f77a83b4db2a129b1be1987cca` |
+| `agent_onboarding/default/general/skills/context_management.md` | PACKAGE | `31358d2607e52b19892970afa7b08cd3835416aa26decc5a377555a2a0f9d0cc` |
 | `agent_onboarding/default/general/skills/context_window_budget.md` | PACKAGE | `d3188124914b8ea1f5d2fb488207ca0720a02e5e61f6f54355a4db4693bf2346` |
 | `agent_onboarding/default/general/skills/execution_contract.md` | PACKAGE | `92b61c0d6c39e3eb49fa89fe972c1774b1f7dbc3ad0e3c6d50ed6a7742e6219a` |
 | `agent_onboarding/default/general/skills/general.md` | PACKAGE | `cb43e243d879bfb30e70d03685449a3f25cbd54b5491e9a45c150b9234c66081` |
@@ -169,7 +170,8 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/general/skills/github/setup.ps1` | PACKAGE | `7c19a462c053ecc8c0ac8a1d7dc7da860e7537d124847210ec200ceaa50f9c06` |
 | `agent_onboarding/default/general/skills/github/setup.sh` | PACKAGE | `c215cdf40e2265a0e84be71db604963350e3efd142e9741f7fafe205c5c54db8` |
 | `agent_onboarding/default/general/skills/github/workflow.md` | PACKAGE | `d47844b15c86afa4034b1fe559e250574eb7d0220f090886b063d64ca728ca67` |
-| `agent_onboarding/default/general/skills/harness_custom_instructions.md` | PACKAGE | `8c1e4f2949e092785ed35117ac5239c619ab64c791a6c2a749a575a95482dc9f` |
+| `agent_onboarding/default/general/skills/harness_custom_instructions.md` | PACKAGE | `9c77040096c25254ea55986068136ee5bfad299788312c3f446879a79b1e10aa` |
+| `agent_onboarding/default/general/skills/harness_custom_instructions_setup.md` | PACKAGE | `6d9d74e42247002f2dcfa68e732b9494b6c45c0701f00acc8136bce4919e2add` |
 | `agent_onboarding/default/general/skills/llm_full_usage.md` | PACKAGE | `00cf47f3eda35e3a3ab3506d7eba5ef31e35384c5902425c9d6286502c84273c` |
 | `agent_onboarding/default/general/skills/mailbox_protocol.md` | PACKAGE | `fb2eafebbdbfa578df0b5b83a253eca43a63426fbfdece09d08e2c96b9465b76` |
 | `agent_onboarding/default/general/skills/memory_management.md` | PACKAGE | `4ab1a61f18aef3db56e730cfdabbd6dbc2b714b9c484ca8cacd822a46e362e44` |
@@ -177,7 +179,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/general/skills/package_upgrade.md` | PACKAGE | `8ae971532ae9f2207fe20787de7a76a217a8153515a7eef059168de6600f25ae` |
 | `agent_onboarding/default/general/skills/reactive_documentation.md` | PACKAGE | `f0a7eb63ffe980fcc535284950f8962e170a443ca868492ac9b5ddd217fadb14` |
 | `agent_onboarding/default/general/skills/repo_topology.md` | PACKAGE | `72921b765339dfd1a2fb570e5c72679330414a59562061cdc5ec098ad4962f21` |
-| `agent_onboarding/default/general/skills/role_local_workflows.md` | PACKAGE | `b0634d08a2164981779ba3a3ccdf5f254509eeff624a3c0e6133e9eec0da1d84` |
+| `agent_onboarding/default/general/skills/role_local_workflows.md` | PACKAGE | `dff73047562ca9d3b3d1fd76435107ecc5c6dd178dbb501a43748b48096febd7` |
 | `agent_onboarding/default/general/skills/security_and_secrets.md` | PACKAGE | `bd58e29bce07c500a3678ba6571c7955d61309a9ea53f909e8ec9527a98c0cbd` |
 | `agent_onboarding/default/general/skills/self_certification.md` | PACKAGE | `f52b2d367fdbca0f6eb687be935235ba2e7566b6ebfa9fb6bb1f54995ba31aab` |
 | `agent_onboarding/default/general/skills/ticketing.md` | PACKAGE | `f767c8b27cbd7a77fdac029aaf99193b72b3ebfd39b3d650789941763b1f5210` |
@@ -189,7 +191,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/general/skills/user_approved_certification.md` | PACKAGE | `6aeac190ac39f22120937b1e4d0cb6384a02a2f800cea3eaf4224ea056bba37c` |
 | `agent_onboarding/default/general/skills/workflow.md` | PACKAGE | `a7a87420f0aa08cc7c04d7d320d8855b3837150fbb34d19f2cba35c7f01ef3bd` |
 | `agent_onboarding/default/general/skills/work_tracking_backend.md` | PACKAGE | `0044695e4d44fcf383fe6e12d53b8bbcf4db857370dfca20d58ccd48c0bd3c45` |
-| `agent_onboarding/default/general/WORKFLOWS.MD` | PACKAGE | `5df69d8d7fb9d8094d7765eacc58772d74113729da5235293968dce86365c23f` |
+| `agent_onboarding/default/general/WORKFLOWS.MD` | PACKAGE | `db39ab6340aed956f8051e70741e7b438a1da2ee8335c79b8f9bb15078f5e270` |
 | `agent_onboarding/default/general/workflows/cleanup_context_compass.md` | PACKAGE | `284c857fd829d9f183d9e555676ddcea87609bdf91db22a6ebb2ab14b15f402b` |
 | `agent_onboarding/default/general/workflows/README.md` | PACKAGE | `9376b5753db22c7b4264a17229b74cef6e684aa647aae8546b589ce367d10c35` |
 | `agent_onboarding/default/general/workflows/role_creation.md` | PACKAGE | `192c1e18e583cd19316232f24ac8c56b29783ed942bf8433e0c938860e50320d` |
@@ -203,7 +205,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/line_copy_editor/policies/line_copy_editor_handoff_policy.md` | PACKAGE | `07d36aae03afb96dc9f31d7bb9c86078ae0a5d851ec920b6c71ff7de97011aef` |
 | `agent_onboarding/default/line_copy_editor/policies/line_copy_editor_quality_policy.md` | PACKAGE | `530e39a402d77cd28fe0cad3222a132ec334ad71a6c11de273bf357657ca35d9` |
 | `agent_onboarding/default/line_copy_editor/README.md` | PACKAGE | `d92fe03876ecfcc9992bf5930dd312f9e561057c8e5cbf46ab02fa6d9b901223` |
-| `agent_onboarding/default/line_copy_editor/SKILLS.MD` | PACKAGE | `8d7029d87562c15453a579a914184e803553608b680acf1d3bc6dd990ee12066` |
+| `agent_onboarding/default/line_copy_editor/SKILLS.MD` | PACKAGE | `4702ad27fdc85377f867d78b24c93aca8070687306640397464a6fe729ae27c2` |
 | `agent_onboarding/default/line_copy_editor/skills/line_copy_editor.md` | PACKAGE | `0d2c789f2ccb0ac18da4ee69586c2bada2f0faa0036377de5a6c52889f91dcc5` |
 | `agent_onboarding/default/line_copy_editor/skills/line_copy_editor_advanced_context.md` | PACKAGE | `8898681ac7b15ae7eddce5d58e4fcea28387bfebbdcec59f1c45ff91bf04d937` |
 | `agent_onboarding/default/line_copy_editor/skills/line_copy_editor_deliverables.md` | PACKAGE | `5575be4c43db6dd0bfdaa7b41120603882c5e3aa4e8824a52718101ca10ed114` |
@@ -248,7 +250,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/proofreader/policies/proofreader_handoff_policy.md` | PACKAGE | `c33a34f5fe9a9e5fc6c260d1d33fc52160c325fb16afcfe3082b38fd3187b9bd` |
 | `agent_onboarding/default/proofreader/policies/proofreader_quality_policy.md` | PACKAGE | `889d78d3c7f0bb0c0bfb7770b88223fcd60736402d823ae39df70e52fdf21611` |
 | `agent_onboarding/default/proofreader/README.md` | PACKAGE | `8536c13cc434cc2020cb139443ce1feb6e577eaa096afb2797b91ee88ac5b5d6` |
-| `agent_onboarding/default/proofreader/SKILLS.MD` | PACKAGE | `bd2e10aba536f9b0b9837e095a4e0196f08b2c4296d9000db01330531c6c7d64` |
+| `agent_onboarding/default/proofreader/SKILLS.MD` | PACKAGE | `f67c0a58b24ca258ed35c5ef10b52dc0b230e5880f5a87d122933527c45d8ec4` |
 | `agent_onboarding/default/proofreader/skills/proofreader.md` | PACKAGE | `5c9550dd315f139ec210bfbe897f4638232916e4a65252f2e9c7fe1b4a90baa9` |
 | `agent_onboarding/default/proofreader/skills/proofreader_advanced_context.md` | PACKAGE | `84d38d325406746bb6e8adf5b174e1278e7001c0f743aaab73e893e39521dc79` |
 | `agent_onboarding/default/proofreader/skills/proofreader_deliverables.md` | PACKAGE | `fd218a085097d7b37090cf1a1ae919bfbc0cd7a374cff541167786eee97f8a2c` |
@@ -280,7 +282,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/researcher/policies/researcher_handoff_policy.md` | PACKAGE | `7b90bb737845a9a060f2dbc0150e387729aaed653c4647c80330770471665fd1` |
 | `agent_onboarding/default/researcher/policies/researcher_quality_policy.md` | PACKAGE | `a5ef981441142723c63ce280c8c884c02edd0d07640c8b6e222e937676dedc03` |
 | `agent_onboarding/default/researcher/README.md` | PACKAGE | `5cbb8839916e363aba95b2b5e7c7fef0c9287948cafccbbdec1472150ec3ab92` |
-| `agent_onboarding/default/researcher/SKILLS.MD` | PACKAGE | `540a5f4bd716e0bff33cc1cfbf97e5eceba0702d8c7b1253cfa7543f869a9702` |
+| `agent_onboarding/default/researcher/SKILLS.MD` | PACKAGE | `8dbe708c3a413f3c6ac19ce60669e64913242fce2a7244c9ca8e5347d5642151` |
 | `agent_onboarding/default/researcher/skills/researcher.md` | PACKAGE | `c799a6d9313515eba81264cbe6b7909beb30604a8fb748188e8f30cebb8d56ec` |
 | `agent_onboarding/default/researcher/skills/researcher_advanced_context.md` | PACKAGE | `e7d0e0fea22b975b42982b5e9fd4d5f6c266ab797c3d6e5ef037a08fd256ceb0` |
 | `agent_onboarding/default/researcher/skills/researcher_deliverables.md` | PACKAGE | `b651e2ed12e10a085da387965ae280278c1cf4858224435c5ba9a085ab0fa66b` |
@@ -313,7 +315,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/story_designer/policies/story_designer_handoff_policy.md` | PACKAGE | `887139dde12dee54c1d0da3e25facb2ca8081e39b58b4c1b95086c53efccb3e7` |
 | `agent_onboarding/default/story_designer/policies/story_designer_quality_policy.md` | PACKAGE | `56df96d22229c3d2c67db449d09c29e55bbf47dd78e46784c0913ee3e11e81fd` |
 | `agent_onboarding/default/story_designer/README.md` | PACKAGE | `e6921703ee2ea8901ba9f123dd026fdef6bc2eac6299a2f9da1cef1592ee07f7` |
-| `agent_onboarding/default/story_designer/SKILLS.MD` | PACKAGE | `7ba0ecc86e7fa21dd3ad71d7d405f7b1f8dc024a1487208873997ddbf907bd81` |
+| `agent_onboarding/default/story_designer/SKILLS.MD` | PACKAGE | `09f108074102c2901d6d3a34e26949605fc320d3bf15d5c0ff4bc553dae92d2f` |
 | `agent_onboarding/default/story_designer/skills/story_designer.md` | PACKAGE | `c33f01f532c0637ec7dfe00900d1426aabe1afe9b01ab54efe0e680825e8f209` |
 | `agent_onboarding/default/story_designer/skills/story_designer_advanced_context.md` | PACKAGE | `1bb9d65bbbb7eade583d41be5740884005c36e3ca64ccaac1a138616b84ee3b0` |
 | `agent_onboarding/default/story_designer/skills/story_designer_deliverables.md` | PACKAGE | `343b6572d1678e7bf68f9bc40be226f486bd0c94957c5ceca63ec631e4f5e479` |
@@ -326,7 +328,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/default/story_novel_artist/policies/story_novel_artist_handoff_policy.md` | PACKAGE | `450099e3358b0dfb810f9f8e9b4b12c072b0f6b5744120e7e70fe05768169ab7` |
 | `agent_onboarding/default/story_novel_artist/policies/story_novel_artist_quality_policy.md` | PACKAGE | `66d96093d70f692de4e7aef5f24f435097d16e0cc743be0402d9ffcd9bd45ec0` |
 | `agent_onboarding/default/story_novel_artist/README.md` | PACKAGE | `4c71f90c6f69164e9d0daed6f87588e24946b0ca2dd8e9e439d8a1fa82775ee4` |
-| `agent_onboarding/default/story_novel_artist/SKILLS.MD` | PACKAGE | `6dbe6df9c3359a7582e377640f3dddcccd25af8b964e84aee8f19bebdd9a8bc7` |
+| `agent_onboarding/default/story_novel_artist/SKILLS.MD` | PACKAGE | `92f9b1477e76e0bfbe01632752f6d6719f37af98531c96e79e536786b2a882f1` |
 | `agent_onboarding/default/story_novel_artist/skills/story_novel_artist.md` | PACKAGE | `e7adc70dad2cf22479f10751287f733e8ca4902f23791a507e4585ab6aaefb6a` |
 | `agent_onboarding/default/story_novel_artist/skills/story_novel_artist_advanced_context.md` | PACKAGE | `8d74072888a3b9c6ea7fe7c9941c56d0017a2e698204655bef82156e5acc98f9` |
 | `agent_onboarding/default/story_novel_artist/skills/story_novel_artist_deliverables.md` | PACKAGE | `ccfbd0413d71acfccba2585c5337a93033620a2461360f1dae1fc845f4566c04` |
@@ -350,7 +352,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/user_defined/synaptic_finishing_developer/examples/python/pytest_unit_finishing_examples.py` | INSTANCE | `01d4e6c7f384cfe77cb2b9a5aa91935cbd1545abea4ab74547c2fa480dc03a15` |
 | `agent_onboarding/user_defined/synaptic_finishing_developer/policies/synaptic_finishing_developer_policy_overrides.md` | INSTANCE | `0cc76f35aa1b14baf5bdd095e71a9a40a470317a2807e52fa9482891dafbc202` |
 | `agent_onboarding/user_defined/synaptic_finishing_developer/profile_overrides.md` | INSTANCE | `a60a7f92681c14d0b7f6effd5e79b3fed43bd939ad22a8c464c3e97125851859` |
-| `agent_onboarding/user_defined/synaptic_finishing_developer/SKILLS.MD` | INSTANCE | `64b9f257efa576964200f893b904862043abc7ecb8f68b4ade8980d2e99fa3cf` |
+| `agent_onboarding/user_defined/synaptic_finishing_developer/SKILLS.MD` | INSTANCE | `b8e781dfc12a8404a6d1ff343f89cf0914bcdbb1807f0f7f4bb9dc9c61a27107` |
 | `agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/comment_craft.md` | INSTANCE | `854789db17b20c6e43d2020ce9378439e6c70cecf5fada72f3cf4178c1b027ae` |
 | `agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/docstring_craft.md` | INSTANCE | `8927e4eb603e40a1fab06fe534f17b3fc0e382164b3756af470b73ae0d26ddb0` |
 | `agent_onboarding/user_defined/synaptic_finishing_developer/skills/documentation/docstring_test_alignment.md` | INSTANCE | `908215ca5be1c11d47b4cb3da64de6a8ac1b0125b9f1e45859f05030b714c9ae` |
@@ -367,7 +369,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/user_defined/synaptic_finishing_developer/workflows/optimize_pytests_for_repo.md` | INSTANCE | `2dc745940a0a20037c3da22e2b5a7fafa1905f03a48f3ff51e19e3ff0d5f75da` |
 | `agent_onboarding/user_defined/synaptic_finishing_developer/workflows/polish_repo_documentation.md` | INSTANCE | `101053bc5a36c1e5f4649cabe82d0fff7df3ff4ab4035f006b3dea535cd15eb3` |
 | `agent_onboarding/user_defined/synaptic_finishing_developer/workflows/README.md` | INSTANCE | `f495bfbc15c5f9275be4bba33d9131147ad733e221814bdc6694717c9c42a7be` |
-| `agent_onboarding/user_defined/synaptic_python_developer/AGENTS.MD` | INSTANCE | `22b4be9851361017e71953daf9b1fad61d463372055e7402672f5bae4856181b` |
+| `agent_onboarding/user_defined/synaptic_python_developer/AGENTS.MD` | INSTANCE | `c9b409786d372808aff7473176de3dcbd7eecc79ef7eee41f980a12fa59bf2a7` |
 | `agent_onboarding/user_defined/synaptic_python_developer/behavioral_guidelines/synaptic_behavior_overrides.md` | INSTANCE | `d6134d69d3894c4da5dfcc59ffbdc40aa16dcfe6217a64095eb7490dafb0fd85` |
 | `agent_onboarding/user_defined/synaptic_python_developer/examples/python/anti_patterns.py` | INSTANCE | `26caf71884cb238e652c44206d4b44da51dd1386df9ac79ca1302db4b1958b5b` |
 | `agent_onboarding/user_defined/synaptic_python_developer/examples/python/cleanup_patterns.py` | INSTANCE | `20f77dbd1c6bdafc83d7f9f5a2796c58465714737961a2a9b9b71431ff95ed33` |
@@ -380,7 +382,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `agent_onboarding/user_defined/synaptic_python_developer/policies/synaptic_policy_overrides.md` | INSTANCE | `3bbe4757097d6ea33635f0e7fa79b9eeeb4d297f33a219f15b60b0409ea75001` |
 | `agent_onboarding/user_defined/synaptic_python_developer/profile_overrides.md` | INSTANCE | `d44ff6b228afdb3415787629b4933495c45ec4f8f181a8ad2534efd56d6dd9cf` |
 | `agent_onboarding/user_defined/synaptic_python_developer/README.md` | INSTANCE | `406458063eeb04a28520bcc3da9597090c6f990ddb01a1b868dfc4e59c07be3f` |
-| `agent_onboarding/user_defined/synaptic_python_developer/SKILLS.MD` | INSTANCE | `b28af00e1ea9ab01be4de5638b0966cdcbe287952888ef758428911ac68286ab` |
+| `agent_onboarding/user_defined/synaptic_python_developer/SKILLS.MD` | INSTANCE | `65a5e0762d1144049841a3f584cb189d8d3bdc36406054c549a7984d9bbc6dc9` |
 | `agent_onboarding/user_defined/synaptic_python_developer/skills/python/attribute_aliasing_skill_benchmark.py` | INSTANCE | `b2a6bbaabedd58919ab1c25beca31b09d2c6f76b92bebb51223b5235dbe13b27` |
 | `agent_onboarding/user_defined/synaptic_python_developer/skills/python/banned_patterns.md` | INSTANCE | `22373e3bdcadfa6a4a276db26700cad0d349b401431f05db5cc338c337573bab` |
 | `agent_onboarding/user_defined/synaptic_python_developer/skills/python/cleanup_and_disposal.md` | INSTANCE | `b6356e385f446a8c9ac80af752cfc81987df65805ad70e260fee1a5063309362` |
@@ -408,7 +410,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `artifacts/README.md` | RESET | `196e2022e5d708af65d39b7e434c792f5c1374d5eb8b542f4d18ee534bbb4ad3` |
 | `artifact_board.md` | LIVE | `45fa4083b4bb7a25f25cbbcf0e7304fd15d98a8ae7a7a8e492ccd0cd3a3edc93` |
 | `attention_board.md` | LIVE | `3148067306419a7f802960fe2704acafee1c4683bed9f1d7baf775574db79bdc` |
-| `config/context_compass_config.yaml` | CONFIG | `955b2038b584c1b74855ab226101ec34e0e49d86e2bd0ba25fb0c1c96e01900d` |
+| `config/context_compass_config.yaml` | CONFIG | `af8cb61ba59a9b5cbf339219226d8919093c6231e4c62e2cf1bce3ffe18ee054` |
 | `CONTEXT_COMPACTION.md` | PACKAGE | `439b20cebd57305a0de0cad051364525ab0e6139ca11e815ddd04ea36fd2747a` |
 | `context_management/artifacts/.gitkeep` | RESET | `01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b` |
 | `context_management/context_artifact_template.md` | RESET | `9a57525f3160d21612da41c4f371d6ba4f50cf681b0e9009e266c67458187b9e` |
@@ -457,13 +459,13 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `examples/security_review_flow.md` | PACKAGE | `4f4a79abcc9130062637bcd9b6133e59c1d397bab483a8262ec91e72816b1cfb` |
 | `examples/story_designer_task_flow.md` | PACKAGE | `75def243d169840f744772b92088ee5547f7f683f54e7f09c3bf684faa63f864` |
 | `examples/story_novel_artist_task_flow.md` | PACKAGE | `7c1d156952c223002f13573f81765e543a284ce97ba4f8cfeb0cdc20fb10ccd1` |
-| `issue_board.md` | LIVE | `acfd4d5ce81dd375efd55f19f2104d64af938b3dec538e98c94b5932e25466e1` |
+| `issue_board.md` | LIVE | `573c3ed51ab3691341b590ae172a3a75760a078dd1d7a9e7f234395f21ad828f` |
 | `LICENSE` | PACKAGE | `88c41276167ae0f03b2f0dc743040a783b52d4374e75269bce3c3a9c0b5b0b33` |
 | `mailbox_board.md` | LIVE | `03ff6176b1cbdf00fbfe1671b17f0d4efe5be0dfd66bd4234e89fd68672d19d5` |
 | `NOTICE` | PACKAGE | `8f903e125dc5d0d04da8a086f3501255a4aa7c7430c7b826ba6a5f9a7e0c696a` |
 | `PROFILE_CLASS_CREATION_GUIDE.md` | PACKAGE | `d1fe634a3cf3b2acd6cc4c35cb937fc1a9af18e9c1f66f6cf40e122b3473ec0a` |
 | `README.md` | PACKAGE | `55111ca435fc49469ab294dac5c6a41a9a27ace4128340d97bfbb7754ad528cb` |
-| `SKILLS.MD` | PACKAGE | `afff6c19936ac56eb7d6a5d788394c4f8466d7bc3b64dbead5d86248fcb5d276` |
+| `SKILLS.MD` | PACKAGE | `27403c6c170b4c5ef30c7212424a902bee0361553d0fe96950d4311b586d962c` |
 | `special_instructions/README.md` | RESET | `b343bf29795d4dc9903fd92f7e9ce8821c9f270cb400b50394f29d534f091f50` |
 | `system_docs/.gitkeep` | RESET | `e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855` |
 | `system_docs/patches/active/README.md` | RESET | `f0d1e1f0716475bb4e14ad38ae0f8fbb2dcd5a4b4c00d3e366bb38d961dc383b` |
@@ -494,6 +496,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `tools/cleanup_context_compass.py` | PACKAGE | `40e0fad8112c3b16438fb9f3f1d36b1f60b7a42c8b7cc22cf3e9acacc9a38c3d` |
 | `tools/migrate_boards.py` | PACKAGE | `14ff0166908e20fc6768fcb42e77ec81048ff34afecedc93fb729bb9487f06fa` |
 | `tools/package_manifest.py` | PACKAGE | `a4ba22ba590cddaad60b546a631c534c53c686d0d2c0b200d08b45c4583033b0` |
+| `tools/reading_routes.py` | PACKAGE | `df61d9b67b55f01d0aacd41f38ddc7a452903f098f48ee4dfbb8d4de38c168fd` |
 | `tools/system_documents/index_document.py` | PACKAGE | `b17bcea2f4cb527fe5daf23b1e022099210ebdc9ca5c665bd09f21f94bb75753` |
 | `tools/system_documents/python/assemble_graph.py` | PACKAGE | `3edd275ed237f458cf6802e2e5e93227b146fad9607b0db52eb8680575fb5ea4` |
 | `tools/system_documents/python/extract_graph.py` | PACKAGE | `c7202b5919315fdf1b99cefd87675b172e5ced7640278a252f1f682e7a8dbd0f` |
@@ -502,5 +505,7 @@ Everything outside them is STRICT: an upgrade sweeps what is not listed here.
 | `tools/system_documents/python/migrate_authored_graph.py` | PACKAGE | `478b9e7e77520ab65c1cc5aaa8445a8083e48390088e1168c0557b70b03b3687` |
 | `tools/ticket_backend.py` | PACKAGE | `0551f05b82bdf110c90e21bd2785ccd41e483bb39fe6243bd23cad766a73cbd6` |
 | `tools/ticket_design.py` | PACKAGE | `e7a0688926b60f69028bc2180349797db15328bae31255224e0321c4aa9c4141` |
+| `tools/TOKEN_REPORT.md` | PACKAGE | `4eeda08764043b2b0ad36a952b1053ec8c38bd2db205113dcc3883266dbffdd8` |
+| `tools/token_report.py` | PACKAGE | `7fd5525030b337959e565f94e49635cbf9caa92eb3ee79f5110ee82927683b94` |
 | `tools/update_context_compass.py` | PACKAGE | `7fc607d29d47498b7ae682ea24d978b8540da35a44129410745b92904239caba` |
 | `user_defined/README.md` | INSTANCE | `f58639058dabcaafed2f3b589ca12b7eb94ddd45dd356a807b39f2304b90ab33` |

{contextcompass-2.19.3 → contextcompass-2.21.0}/src/context_compass/SKILLS.MD

@@ -84,9 +84,10 @@ not only the question to the user; they do not create unregistered roles.
      A missing key means `local`; resolve legacy values through the shared
      `work_tracking_backend.md` skill. Read the selected backend's paths before
      certification; never apply the inactive backend's storage instructions.
-   - **On-demand** skills are conditional. Do NOT read them for certification
-     unless a trigger condition is met. When the trigger is met, those paths
-     become mandatory and MUST be read before proceeding in that scope.
+   - **On-demand** skills form the lazy readset. Do NOT read them for
+     certification unless a trigger condition is met. When the trigger is met,
+     those paths become mandatory and MUST be read in full before proceeding in
+     that scope.
    - **Self-directed** skills are also outside certification, but they carry no
      trigger. Read them on your own initiative whenever the work needs them.
      Waiting for permission there is the failure the state exists to prevent.
@@ -114,6 +115,18 @@ match on the STATE, never on a list of headings:
 | **On-demand** | no | only when the section's stated trigger fires |
 | **Self-directed** | no | at the agent's own initiative, no trigger, no permission |
 
+**Eager and lazy readsets.** A resolved chain's baseline sections are its *eager
+readset*: read in full at onboarding and at recovery. Its On-demand sections are
+its *lazy readset*, written as an index the agent holds from onboarding. Each
+lazy entry is the usual path line followed by two indented sub-items: `Covers:`
+(what the file is for, in one line) and `Trigger:` (the request, state or action
+that loads it). Sub-items never change the entry line itself. When a trigger
+fires, read that whole file before acting in its scope. Self-directed reads
+belong to neither set: they have no trigger and are read when the work needs them.
+`reading.mode` in config chooses how the lazy readset loads: `lean`, the default,
+reads each entry when its trigger fires; `full` also reads every entry at
+onboarding and recovery.
+
 Baseline sections are named for what they hold — `general` uses **Shared baseline skills**,
 `engineer` uses both **Required baseline skills** and **Baseline system
 orientation**. A role may introduce another; it is still baseline.
@@ -123,7 +136,7 @@ required only for the selected backend, after the config has been read. This is
 a conditional baseline, not an On-demand skill and not a new role.
 
 **On-demand and Self-directed are both outside certification, and they are not the
-same thing.** On-demand is gated: the section states a trigger, and reading before
+same thing.** On-demand is gated: each entry states a trigger, and reading before
 it fires teaches a procedure with nothing to apply it to — `general`'s
 `llm_full_usage.md` is the model, useless on an install with no `llm_full.md`.
 Self-directed is the opposite failure being guarded against: the document is

{contextcompass-2.19.3 → contextcompass-2.21.0}/src/context_compass/agent_onboarding/default/continuity_fact_checker/SKILLS.MD

@@ -33,12 +33,12 @@ Required baseline skills
 - `agent_onboarding/default/continuity_fact_checker/behavioral_guidelines/continuity_fact_checker_workflow.md`
 - `agent_onboarding/default/continuity_fact_checker/examples/continuity_fact_checker_task_flow.md`
 
-On-demand role-context skills
-Trigger conditions (any one makes these mandatory):
-- Task requires cross-book canon synchronization.
-- Task requires alternate timeline branch management.
-- Task requires compliance-sensitive factual verification.
+On-demand role-context skills (lazy readset index)
 
-If triggered:
 - `agent_onboarding/default/continuity_fact_checker/skills/continuity_fact_checker_advanced_context.md`
-- Do not proceed in this specialized scope until the on-demand read is satisfied.
+  - Covers: the extra requirements for advanced continuity fact checker work.
+  - Trigger: any one of these.
+    - Task requires cross-book canon synchronization.
+    - Task requires alternate timeline branch management.
+    - Task requires compliance-sensitive factual verification.
+  - Do not proceed in that specialized scope until this file is read.

{contextcompass-2.19.3 → contextcompass-2.21.0}/src/context_compass/agent_onboarding/default/design_engineer/AGENTS.MD

@@ -4,16 +4,8 @@
 ## PRIME DIRECTIVE
 Certification is denied unless the resolved SKILLS chain is satisfied exactly.
 
-- You MUST read every path in every section a resolved `SKILLS.MD` marks as
-  **baseline** (parent-first). Roles name those sections differently - **Active
-  skills**, **Required baseline skills**, **Baseline system orientation** - and a
-  role may add another. Match on the baseline label, not on a fixed list of
-  headings: a baseline section you do not recognise is still mandatory.
-- Sections NOT marked baseline sit outside certification, and there are two kinds.
-  **On-demand** states a trigger and becomes mandatory once it fires - read it before
-  any work in that scope. **Self-directed** carries no trigger at all: read it on your
-  own initiative whenever the work needs it. Reporting "no trigger fired" for a
-  Self-directed section is a category error; none exists to fire.
+- Read every baseline section in the resolved chain, parent-first. Lazy (On-demand)
+  entries load in full when their trigger fires; Self-directed reading has no trigger.
 - You MUST NOT claim a skill was read unless it was actually read.
 
 ## 1) Purpose