ICN Live State Overlay Template

Fill this overlay at the start of any non-trivial session. It grounds the agent in current project reality.

This is a template. The content you fill in comes from the canonical documents listed below. Do not cache or inherit overlay content from a previous session — always reload.


Files to Load First

Load these files and extract current state before beginning work:

  1. docs/ai/ICN_CONSTITUTIONAL_CORE.md — reasoning foundation (stable, rarely changes)
  2. docs/STATE.md — declared project state
  3. docs/PHASE_PROGRESS.md — phase tracking and metrics
  4. Latest handoff in docs/dev/ (find by date: ls -t docs/dev/handoff-*.md | head -1)
  5. Active tranche/execution docs relevant to current task (if any)

Declared Project State

Current phase:

Phase status: <complete / in-progress / blocked — with blocker if any>

Strongest landed core:

Weakest / most partial areas:

Major project risk:


Current Execution Direction

Latest handoff: docs/dev/handoff-YYYY-MM-DD.md

Current branch:

Open PRs:

Merge order / next steps: <from handoff "Next Move" section>

Active tranche docs: <paths to any NYCN-Execution-Tranches.md or similar, if relevant>


Current Ontology / Model Direction

<Summarize the current entity/structure/activity model, naming conventions, authority model, and any locked architectural decisions relevant to the current task.>


Conventions to Preserve

  • Events:
  • Storage keys:
  • HTTP routes:
  • Kernel boundary:
  • Domain-specific content:

Workspace Notes

  • Rust workspace: icn/ (all cargo commands run from here)
  • Key verification commands:
    <from handoff or CLAUDE.md>
    

Divergences Discovered

  • <divergence description — e.g., "STATE.md says X but code shows Y">
  • <or "None discovered" if everything aligns>