docs: consolidate agent execution and custody

README.md

@@ -37,7 +37,7 @@ python3 -m build && make install-local
 source .venv/bin/activate  # Required for each session
 ```
 
-**From Forgejo PyPI (v1.1.0+):**
+**From Forgejo PyPI (current release: v1.4.0):**
 ```bash
 pip install kaizen-agentic \
   --extra-index-url https://forgejo.coulomb.social/api/packages/coulomb/pypi/simple/
@@ -89,7 +89,7 @@ kaizen-agentic memory init sys-medic
 kaizen-agentic memory brief tdd-workflow
 
 # Review an agent's accumulated knowledge
-kaizen-agentic memory show project-management
+kaizen-agentic memory show project-assistant
 ```
 
 See [docs/agency-framework.md](docs/agency-framework.md) for the full model.
@@ -105,17 +105,22 @@ Read in this order for strategic context:
 5. [SCOPE.md](SCOPE.md) — repository boundaries and current state
 6. [history/](history/) — persisted assessments and gap analyses
 
-Released **v1.1.0** — see [CHANGELOG.md](CHANGELOG.md). Workplans: WP-0001 through WP-0004 completed.
+Released **v1.4.0** — see [CHANGELOG.md](CHANGELOG.md). Repository state and
+completed delivery are summarized in [SCOPE.md](SCOPE.md) and
+[WORK-RECORDS.md](WORK-RECORDS.md).
 
 Feedback: `kaizen-agentic feedback` · [docs/FEEDBACK.md](docs/FEEDBACK.md)
 
 ## Features
 
-- **20 Specialized Agents**: Project management, testing, code quality, infrastructure, meta
+- **20 Specialized Agents**: Planning, testing, code quality, infrastructure, release, and meta-agent craft
 - **Agency Framework**: Project-scoped agent memory + Coach meta-agent for cross-agent synthesis
-- **CLI Tool**: Easy agent installation, management, and memory commands (`kaizen-agentic`)
+- **Metrics and Improvement Loop**: Session evidence, optimizer recommendations, and optional artifact publication
+- **Roles and Engagements**: Versioned role packages, client-bound engagement records, lifecycle checklists, and custody controls
+- **Scheduled Preparation**: Repo-local schedules and offline orientation bundles for activity-core/rein-aharness execution
+- **CLI Tool**: Agent, memory, metrics, protocol, engagement, and schedule commands (`kaizen-agentic`)
 - **Project Templates**: Pre-configured setups for different project types
-- **Claude Code Integration**: Seamless integration with Claude Code workflows
+- **Runtime-neutral Contracts**: Instruction and preparation surfaces usable by governed coding-agent harnesses
 - **Comprehensive Testing**: Full test coverage with multiple testing strategies
 
 ## Available Agents
@@ -124,26 +129,44 @@ Feedback: `kaizen-agentic feedback` · [docs/FEEDBACK.md](docs/FEEDBACK.md)
 - **keepaTodofile**: Manages TODO.md files following Keep a Todofile format
 - **keepaChangelog**: Maintains CHANGELOG.md files following Keep a Changelog format
 - **keepaContributingfile**: Creates and updates CONTRIBUTING.md files
-- **project-management**: General project management and coordination
+- **project-assistant**: General project planning and coordination
+- **priority-evaluation**: Evaluates and orders competing work
+- **requirements-engineering**: Requirements analysis and documentation
+- **scope-analyst**: Maintains explicit product and repository boundaries
+- **releaseManager**: Coordinates release readiness and delivery
 
 ### Development Process
 - **tdd-workflow**: Test-driven development workflow guidance
-- **requirements-engineering**: Requirements analysis and documentation
 - **test-maintenance**: Test suite maintenance and optimization
+- **testing-efficiency**: Improves test feedback speed and signal quality
 
 ### Code Quality
 - **code-refactoring**: Code improvement and refactoring guidance
 - **optimization**: Agent definition optimization and improvement
 - **datamodel-optimization**: Data model design and optimization
+- **tooling-optimization**: Improves effective use of repository tooling
 
 ### Infrastructure
 - **setupRepository**: Repository initialization and standards compliance
 - **claude-documentation**: Claude Code configuration and documentation
-- **tooling-optimization**: Repository tooling usage optimization
 - **sys-medic**: Infrastructure health monitoring and diagnostics
 
 ### Meta
 - **coach**: Coaching meta-agent — reads all project agent memories, synthesises cross-agent briefs, and orients incoming agents
+- **wisdom-encouragement**: Encourages reflective, evidence-backed improvement
+
+## Automated execution boundary
+
+Kaizen Agentic defines agent craft, validates repo-local schedules, and prepares
+offline execution bundles. In the current unattended path, **activity-core**
+creates durable, claimable `ops_run` work and **rein-aharness** resolves policy,
+credentials, runtime profile, model, and sandbox before executing the bounded
+agent session. State Hub supplies roster and coordination evidence.
+
+Manual execution remains supported. Kaizen Agentic itself does not own cron,
+the durable work queue, inference, credentials, or runtime authorization. See
+[Integration Patterns](docs/INTEGRATION_PATTERNS.md) and
+[ADR-005](docs/adr/ADR-005-scheduled-agent-execution.md).
 
 [View complete agent list](docs/AGENT_DISTRIBUTION.md#agent-categories)