dot-claude-iff

What makes us human, built into Claude: adapt to context · evolve to challenge · communicate to partner.

Agent sessions forget, work unseen, ask badly, and rot - so you re-explain context every morning, catch problems three sessions late, and answer "should I?" with no situation attached. dot-claude-iff is a .claude/ operating system that fixes this at the mechanism level: it harnesses the agent, records everything locally, and hands you one live page to command it all.

Have an agent adopt it for you - paste this to Claude Code (or any capable coding agent) inside the repo you want it in:

Clone https://github.com/Sdamirsa/dot-claude-iff to a sibling folder outside this repo, then
adopt its system into this repo by following the cloned repo's .claude/skills/adopt/SKILL.md
end to end. This repo may already have a .claude directory: merge, never overwrite, and report
every conflict to me before deciding.

%%{init: {"themeVariables": {"fontFamily": "Arial, Helvetica, sans-serif", "fontSize": "14px"}, "flowchart": {"htmlLabels": false, "padding": 18, "nodeSpacing": 40, "rankSpacing": 55}}}%%
flowchart TD

  subgraph group_session["Session harness"]
    node_hooks["Session hooks<br/>[hooks]"]
    node_policy["Policy gate<br/>[policy_gate.py]"]
    node_checks["Secrets and system checks<br/>[checkctl.py]"]
  end

  subgraph group_memory["Memory and ritual"]
    node_record[("Event record<br/>[state]")]
    node_heartbeat["Heartbeat and usage<br/>[heartbeat.sh]"]
    node_ritual["Project memory ritual<br/>[SKILL.md]"]
    node_check["Reality check<br/>[project-memory]"]
    node_polish["Memory rebuild<br/>[project-memory]"]
    node_publish["Seal and publish<br/>[project-memory]"]
    node_evolve["Evidence-based evolution<br/>[project-memory]"]
    node_route["Next-session routing<br/>[project-memory]"]
    node_state["Modes and phases<br/>[statectl.py]"]
  end

  subgraph group_visibility["Visibility and control"]
    node_console["Command console<br/>[console.py]"]
    node_systemmap["Clickable system map<br/>[mapctl.py]"]
    node_export["Visibility and export<br/>[distctl.py]"]
    node_progress["Progress view<br/>[progress.py]"]
    node_codegraph[("Code graph<br/>[graphctl.py]")]
    node_architecture["Architecture diagram<br/>[mapctl.py]"]
  end

  subgraph group_extension["Orchestration and adoption"]
    node_orchestration["Fableous orchestration<br/>[orchestration.md]"]
    node_dispatch["Worktree dispatch<br/>[statectl.py]"]
    node_adoption["Merge-based adoption<br/>[SKILL.md]"]
    node_worktree["Worktree sessions, Cview-ready<br/>[_lib.py]"]
  end

  node_human(("Human<br/>maintainer"))
  node_agent(("Claude Code<br/>agent"))

  node_human -->|"starts"| node_ritual
  node_agent -->|"suggests"| node_ritual
  node_ritual -->|"checks reality"| node_check
  node_ritual -->|"rebuilds memory"| node_polish
  node_ritual -->|"publishes"| node_publish
  node_ritual -->|"proposes changes"| node_evolve
  node_ritual -->|"routes session"| node_route
  node_human -->|"approves changes"| node_evolve
  node_hooks -->|"captures events"| node_record
  node_heartbeat -->|"records turns"| node_record
  node_policy -->|"gates mistakes"| node_agent
  node_state -->|"sets mode and phase"| node_route
  node_console -->|"shows status"| node_human
  node_console -->|"presents questions"| node_human
  node_human -->|"returns answer"| node_agent
  node_systemmap -->|"maps components"| node_console
  node_codegraph -->|"feeds"| node_architecture
  node_systemmap -->|"feeds"| node_architecture
  node_architecture -->|"renders in the MAP tab"| node_console
  node_progress -->|"shows progress"| node_human
  node_export -->|"offers export"| node_human
  node_orchestration -->|"defines dispatch"| node_dispatch
  node_dispatch -->|"dispatches builders"| node_agent
  node_dispatch -->|"opens"| node_worktree
  node_worktree -->|"one worker per task"| node_agent
  node_adoption -->|"guides installation"| node_agent
  node_checks -->|"reports findings"| node_human

  classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
  classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
  classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
  classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
  classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
  class node_hooks,node_policy,node_checks toneBlue
  class node_record,node_heartbeat,node_ritual,node_check,node_polish,node_publish,node_evolve,node_route,node_state toneAmber
  class node_console,node_systemmap,node_export,node_progress,node_codegraph,node_architecture toneMint
  class node_orchestration,node_dispatch,node_adoption,node_worktree toneRose
  class node_human,node_agent toneIndigo

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗