docs: define modular local agent contracts

docs/README.md

@@ -1,6 +1,6 @@
 # GEWU architecture and engineering handbook
 
-Started 12 October 2026; revised 13 October 2026. Architecture proposal v0.2; implementation has not started.
+Started 12 October 2026; revised 13 October 2026. Architecture proposal v0.3. The initial local-agent instruction pack exists; service, connector and UI implementation has not started.
 
 **Tagline:** Investigate. Connect. Remember.
 
@@ -15,8 +15,10 @@ GEWU (格物) draws on *géwù zhìzhī* (格物致知), a classical phrase comm
 5. [Visual design protocol](development/VISUAL_DESIGN_PROTOCOL.md): the owner-selected editorial research direction and its review gates.
 6. [Agent and security protocol](development/AGENT_SECURITY_PROTOCOL.md): agent workflows, permissions, untrusted inputs and client acceptance.
 7. [Operations protocol](development/OPERATIONS_PROTOCOL.md): persistence, deployment, backup, migration and incident response.
+8. [Local agent](architecture/LOCAL_AGENT.md) and [source pack](../agents/gewu/README.md): RESEARCH-style workspace profile, modular skills and pipeline procedures.
+9. [Module replacement protocol](development/MODULARITY_PROTOCOL.md): public contracts, dependency boundaries, replacement tests, state migration and rollback.
 
-The [independent architecture review](reviews/ARCHITECTURE_SENIOR_REVIEW.md) records the original findings, corrections and limits of verification.
+The [independent architecture review](reviews/ARCHITECTURE_SENIOR_REVIEW.md) records findings and corrections for the v0.2 acceptance foundation. The [local-agent and modularity addition](reviews/LOCAL_AGENT_MODULARITY_REVIEW.md) records the v0.3 scope and verification separately.
 
 ## Decision status
 
@@ -24,6 +26,7 @@ The [independent architecture review](reviews/ARCHITECTURE_SENIOR_REVIEW.md) rec
 | --- | --- |
 | Product requirement | Already stated in GOAL/PRD; this proposal must satisfy it. |
 | Owner-selected direction | Warm editorial research workspace, confirmed in this conversation. Exact tokens and layouts remain proposed. |
+| Owner-required additions | Custom local agent in the RESEARCH workspace style; modular development across all components with tested replacement paths. |
 | Architecture recommendation | Concrete engineering default for review; no implementation or measured acceptance implied. |
 | Open owner decision | A policy, staffing, capacity or content choice that engineering cannot present as approved. |
 
@@ -35,4 +38,4 @@ Start with a disposable local vertical slice: upload an explicitly selected text
 
 Before that boundary becomes a pilot deployment, settle the open decisions listed in the architecture. Implementing a smaller slice does not reduce the PRD's full-v1 requirements for hybrid retrieval, supported source formats, four agent harnesses and portable operation.
 
-Runtime versions will be pinned in lockfiles during scaffolding after compatibility checks. There are currently no application manifests, runnable service, browser implementation or deployment tests in this repository. The documents are a reviewable design, not a completion report.
+Runtime versions will be pinned in lockfiles during scaffolding after compatibility checks. The agent pack has an instruction/version manifest, but there are no application dependency manifests, runnable service, browser implementation or deployment tests in this repository. Skill-file validation is separate from installed discovery and live workflow acceptance.