2 Commits

Include renames

Author	SHA1	Message	Date
ed	8b7b8b96c7	docs(styleguides+harness-plan): fix stale models.py refs + harness plan line drift ... Styleguides: - agent_memory_dimensions.md: FileItem/ContextPreset line refs (src/models.py:510-559 / 909-937) -> src/project_files.py + src/context_presets.py (moved per module_taxonomy_refactor_20260627). - config_state_owner.md: 'file I/O primitives in src/models.py' -> src/project_manager.py (the config-load/save helpers moved). - python.md §10 NOT-exempt list: '12 per-aggregate types' -> ~19; 'dataclass types in src/models.py' -> per-system files enumeration (mma.py, project_files.py, mcp_tool_specs.py, result_types.py, personas.py, workspace_manager.py, mcp_client.py). - type_aliases.md: type-registry lookup examples updated to the per-system files (src_mma.md, src_project_files.md, etc.); the 'src/models.py: 48 dataclass field types' worked-example line is flagged as historical (pre-refactor state). Harness plan (directive_hotswap_harness_20260627/plan.md): - §17 line refs corrected: 17.1 220-237 -> 247-264; 17.2 239-250 -> 266-277; 17.3 252-272 -> 279-299; 17.4 274-299 -> 301-326; 17.5 301-311 -> 328-338; 17.6 313-323 -> 340-350; 17.7 325-327 -> 352-354; 17.9 336-409 -> 364-443. - §17 master range 216-409 -> 243-473. - §12 175-184 -> 202-211; §13 185-199 -> 212-224; §15 205-215 -> 234-241. - error_handling.md: hard rules 212-242 -> 212-264; boundary types 274-311 -> 284-365. - type_aliases.md: 40-81 -> 13-87 + 89-160 + 284-365 (the alias table + decision pattern 2.5 + boundary/anti-pattern sections).	2026-07-02 19:31:32 -04:00
ed	35c6cca134	docs: agent workflow docs + regular docs (v2.3 surfacing) ... Per user request 'use your remaining context to update agent workflow docs and then regular docs based on what was discussed in this report', this commit creates/updates 15 files derived from the v2.3 nagent review (the 12 new nagent additions + the 4 memory dimensions reframing + the cache strategy + the RAG discipline + the knowledge harvest pattern). Agent workflow docs (4 files): - AGENTS.md (UPDATE): add @import line to canonical DOD + 'Code Styleguides' section pointing to the 6 new styleguides + new 'Human-Facing Documentation' section pointing to ./docs/AGENTS.md - conductor/workflow.md (UPDATE): new section 'Additions (2026-06-12) - the 12 patterns from the latest nagent corpus' with TDD protocols for knowledge harvest, cache ordering, compaction, RAG discipline - conductor/product-guidelines.md (UPDATE): new sections 'Memory Dimensions (added 2026-06-12)' + 'See Also - Updated' with the 6-styleguide catalog - docs/AGENTS.md (NEW): the agent-facing mirror of docs/Readme.md (per the nagent CLAUDE.md pattern). 10 sections + the per-tier reading path + the 4 memory dimensions + the caching strategy + the knowledge harvest + the RAG discipline + the feature flags Regular docs (11 files): - 6 new styleguides (the convention catalog): * data_oriented_design.md: the canonical DOD reference (Tier 0/1/2; 3 defaults to reject; 8 core defaults; 7-question simplification pass; 10-question self-check; 4 memory dimensions in Manual Slop context) * agent_memory_dimensions.md: the 4 memory dims (curation / discussion / RAG / knowledge) + when to use each + the boundaries * rag_integration_discipline.md: the conservative-RAG rule (opt-in, complement, provenance, no mutation, feature-gated, graceful failure) * cache_friendly_context.md: stable-to-volatile context ordering + the cache TTL GUI contract + the byte-comparison test * knowledge_artifacts.md: the knowledge harvest pattern (category files, provenance, sha256 ledger, digest regeneration, 'delete to turn off') * feature_flags.md: file presence vs config flags vs CLI flags - 3 new project docs (the cross-cutting guides): * guide_agent_memory_dimensions.md: the cross-cutting guide on the 4 dims + the decision tree * guide_caching_strategy.md: caching across providers + stable-to-volatile ordering + cache TTL GUI + the byte- comparison test + the 5th provider (claude-code) * guide_knowledge_curation.md: the knowledge memory guide (4th dim) + the 5 category files + per-file notes + the digest + the ledger + the harvest workflow - 2 existing doc updates: * guide_mma.md: new sections 'Delegation as context management' + 'The 4 memory dimensions (the MMA scope)' * guide_ai_client.md: new section 'Cache strategy and the 12- layer model' + the 5th provider (claude-code) All files use the same style as the v2.3 review (the user's preferred format): 7-column tables, no JSON, SSDL shape tags, forth/array notation, file:line citations, ASCII sketches where useful. The human Readme files (Readme.md, docs/Readme.md) are NOT modified (per repeated user instruction). The 5th provider (claude-code) is documented in guide_ai_client.md + the data_oriented_design.md references the nagent pattern as the source of the canonical rules. The cross-references are bidirectional: the 6 styleguides reference the 3 project docs; the 3 project docs reference the 6 styleguides; the 2 doc updates reference both; AGENTS.md + ./docs/AGENTS.md provide the entry points.	2026-06-12 13:50:40 -04:00