doc-behavior-processes

Packet · {{ repo }} · behavior/processes.md

1. Objective

Produce {{ docs_root }}/behavior/processes.md: one H2 per top process in {{ repo }}, each with a numbered step list citing path:LOC on every line, entry-point attribution (HTTP route / MCP tool / CLI command / scheduled job), and a ### Related subsection with backtick citations to handler files.

2. Scope

• Create: {{ docs_root }}/behavior/processes.md
• Do not touch: {{ docs_root }}/behavior/state-machines.md, any other file under {{ docs_root }}/, any source file in the repo, .context.md, .prefetch.md, or any .packets/*.md other than this one.

3. Input specification

Source	Read how	Cache state
Shared context	Read {{ context_path }}	always first
Prefetch ledger	Read {{ prefetch_path }}	always first
Top processes	{{ context_path }} § Top processes	cached
Route inventory	{{ prefetch_path }} § route_map	cached
MCP tool inventory	{{ prefetch_path }} § tool_map	cached
Step sequence per process	mcp__codehub__context({symbol: <process-name>})	mid-run
Disambiguation lookup	mcp__codehub__query({text: "<process name>"})	mid-run, only on collision

4. Process

1. Read {{ context_path }} and Read {{ prefetch_path }}. Confirm the Top processes list is present; if empty, follow Fallback paths.
2. Select the top 8 processes from .context.md § Top processes (ranked by step_count).
3. For each of the 8: call mcp__codehub__context({symbol: <process-name>}) to pull entry point, ordered outbound calls, and handler files. Cache the per-process digest in this packet's Work log.
4. Group each process by its initiator using the cached route_map / tool_map digest: HTTP route, MCP tool, CLI command, scheduled job, or internal.
5. Draft processes.md with H1 = {{ repo }} · Processes. One H2 per process (max 8). Under each H2: a single-line Entry point: <path:LOC>, a numbered step list where every step cites path:LOC, then a ### Related subsection listing the top 3-6 handler/helper files as backtick citations.
6. Processes with fewer than 3 concrete steps collapse into a trailing ## Minor flows H2 (one bullet per flow, not an H2 section of their own).
7. Write {{ docs_root }}/behavior/processes.md.