# engindemirog/roombook architecture

> Architecture diagram of the GitHub repository engindemirog/roombook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/engindemirog/roombook
- Repository: https://github.com/engindemirog/roombook

## Overview

ANEW is a file-based workspace for guiding AI-assisted software development, not an application framework. The main workflow moves from bootstrap and feature intent through clarification, specification, planning, human approval, implementation, independent review, verification, and shipping. Its supporting capabilities include durable project memory, recovery prompts, role guidance, health checks, and tool adapters. The README documents these relationships; no source excerpts were supplied, so unsampled implementation details and call-level links are omitted.

Main entry points: [`workflows/feature-development.md`](https://github.com/engindemirog/roombook/blob/main/workflows/feature-development.md) (Feature Development), [`workflows/bootstrap.md`](https://github.com/engindemirog/roombook/blob/main/workflows/bootstrap.md) (Bootstrap), [`prompts`](https://github.com/engindemirog/roombook/tree/main/prompts) (Workflow Prompts), [`scripts/init`](https://github.com/engindemirog/roombook/blob/main/scripts/init) (Adapter Installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_process["Workflows"]
  node_bootstrap["Bootstrap<br/>[bootstrap.md]"]
  node_feature["Feature Development"]
  node_bugfix["Bug Fix<br/>[bug-fix.md]"]
  node_refactor["Refactor<br/>[refactor.md]"]
  node_incident["Incident<br/>[incident.md]"]
end

subgraph group_memory["Project Memory"]
  node_specs["Specs and Plans"]
  node_projectdocs["Project Context"]
  node_decisions["Decision Records"]
  node_agents["Agent Signpost<br/>[AGENTS.md]"]
end

subgraph group_guidance["Prompts and Roles"]
  node_prompts["Workflow Prompts"]
  node_recovery["Recovery Prompts"]
  node_roles["Role Cards"]
end

subgraph group_controls["Workspace Controls"]
  node_check["Verification Contract"]
  node_doctor["Workspace Health"]
  node_init["Adapter Installer"]
end

subgraph group_adapters["Tool Adapters"]
  node_claude["Claude Code Adapter"]
  node_copilot["GitHub Copilot Adapter"]
  node_cursor["Cursor Adapter"]
  node_generic["Generic Adapter"]
end

node_human(("Human"))
node_ai(("AI Tool"))

node_human -->|"starts setup"| node_bootstrap
node_ai -->|"runs workflow"| node_bootstrap
node_bootstrap -->|"fills context"| node_projectdocs
node_bootstrap -->|"fills signpost"| node_agents
node_bootstrap -->|"configures"| node_check
node_human -->|"starts work"| node_feature
node_ai -->|"follows workflow"| node_feature
node_feature -->|"creates spec and plan"| node_specs
node_feature -->|"assigns roles"| node_roles
node_feature -->|"uses prompts"| node_prompts
node_bugfix -->|"uses prompts"| node_prompts
node_refactor -->|"uses prompts"| node_prompts
node_incident -->|"uses prompts"| node_prompts
node_prompts -->|"catalogs recovery"| node_recovery
node_human -->|"approves plan"| node_specs
node_human -->|"triages findings"| node_feature
node_ai -->|"runs verification"| node_check
node_human -->|"runs verification"| node_check
node_doctor -->|"reports workspace health"| node_ai
node_init -->|"installs adapter"| node_claude
node_init -->|"installs adapter"| node_copilot
node_init -->|"installs adapter"| node_cursor
node_init -->|"installs adapter"| node_generic
node_ai -->|"loads context"| node_agents
node_projectdocs -->|"includes ADRs"| node_decisions

click node_bootstrap "https://github.com/engindemirog/roombook/blob/main/workflows/bootstrap.md"
click node_feature "https://github.com/engindemirog/roombook/blob/main/workflows/feature-development.md"
click node_bugfix "https://github.com/engindemirog/roombook/blob/main/workflows/bug-fix.md"
click node_refactor "https://github.com/engindemirog/roombook/blob/main/workflows/refactor.md"
click node_incident "https://github.com/engindemirog/roombook/blob/main/workflows/incident.md"
click node_specs "https://github.com/engindemirog/roombook/tree/main/specs"
click node_projectdocs "https://github.com/engindemirog/roombook/tree/main/docs"
click node_decisions "https://github.com/engindemirog/roombook/tree/main/docs/decisions"
click node_agents "https://github.com/engindemirog/roombook/blob/main/AGENTS.md"
click node_prompts "https://github.com/engindemirog/roombook/tree/main/prompts"
click node_recovery "https://github.com/engindemirog/roombook/tree/main/prompts/recovery"
click node_roles "https://github.com/engindemirog/roombook/tree/main/docs/roles"
click node_check "https://github.com/engindemirog/roombook/blob/main/scripts/check"
click node_doctor "https://github.com/engindemirog/roombook/blob/main/scripts/doctor"
click node_init "https://github.com/engindemirog/roombook/blob/main/scripts/init"
click node_claude "https://github.com/engindemirog/roombook/tree/main/adapters/claude-code"
click node_copilot "https://github.com/engindemirog/roombook/tree/main/adapters/github-copilot"
click node_cursor "https://github.com/engindemirog/roombook/tree/main/adapters/cursor"
click node_generic "https://github.com/engindemirog/roombook/tree/main/adapters/generic"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
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
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_bootstrap,node_feature,node_bugfix,node_refactor,node_incident toneBlue
class node_specs,node_projectdocs,node_decisions,node_agents toneAmber
class node_prompts,node_recovery,node_roles toneMint
class node_check,node_doctor,node_init toneRose
class node_claude,node_copilot,node_cursor,node_generic,node_human,node_ai toneIndigo
```

## Components

### Workflows

- [Bootstrap](https://github.com/engindemirog/roombook/blob/main/workflows/bootstrap.md): `workflows/bootstrap.md`
- [Feature Development](https://github.com/engindemirog/roombook/blob/main/workflows/feature-development.md): `workflows/feature-development.md`
- [Bug Fix](https://github.com/engindemirog/roombook/blob/main/workflows/bug-fix.md): `workflows/bug-fix.md`
- [Refactor](https://github.com/engindemirog/roombook/blob/main/workflows/refactor.md): `workflows/refactor.md`
- [Incident](https://github.com/engindemirog/roombook/blob/main/workflows/incident.md): `workflows/incident.md`

### Project Memory

- [Specs and Plans](https://github.com/engindemirog/roombook/tree/main/specs): `specs`
- [Project Context](https://github.com/engindemirog/roombook/tree/main/docs): `docs`
- [Decision Records](https://github.com/engindemirog/roombook/tree/main/docs/decisions): `docs/decisions`
- [Agent Signpost](https://github.com/engindemirog/roombook/blob/main/AGENTS.md): `AGENTS.md`

### Prompts and Roles

- [Workflow Prompts](https://github.com/engindemirog/roombook/tree/main/prompts): `prompts`
- [Recovery Prompts](https://github.com/engindemirog/roombook/tree/main/prompts/recovery): `prompts/recovery`
- [Role Cards](https://github.com/engindemirog/roombook/tree/main/docs/roles): `docs/roles`

### Workspace Controls

- [Verification Contract](https://github.com/engindemirog/roombook/blob/main/scripts/check): `scripts/check`
- [Workspace Health](https://github.com/engindemirog/roombook/blob/main/scripts/doctor): `scripts/doctor`
- [Adapter Installer](https://github.com/engindemirog/roombook/blob/main/scripts/init): `scripts/init`

### Tool Adapters

- [Claude Code Adapter](https://github.com/engindemirog/roombook/tree/main/adapters/claude-code): `adapters/claude-code`
- [GitHub Copilot Adapter](https://github.com/engindemirog/roombook/tree/main/adapters/github-copilot): `adapters/github-copilot`
- [Cursor Adapter](https://github.com/engindemirog/roombook/tree/main/adapters/cursor): `adapters/cursor`
- [Generic Adapter](https://github.com/engindemirog/roombook/tree/main/adapters/generic): `adapters/generic`

### Other components

- **Human**
- **AI Tool**

## Connections

- Human → Bootstrap: starts setup (evidence: `README.md`)
- AI Tool → Bootstrap: runs workflow (evidence: `README.md`)
- Bootstrap → Project Context: fills context (evidence: `README.md`)
- Bootstrap → Agent Signpost: fills signpost (evidence: `README.md`)
- Bootstrap → Verification Contract: configures (evidence: `README.md`)
- Human → Feature Development: starts work (evidence: `README.md`)
- AI Tool → Feature Development: follows workflow (evidence: `README.md`)
- Feature Development → Specs and Plans: creates spec and plan (evidence: `README.md`)
- Feature Development → Role Cards: assigns roles (evidence: `README.md`)
- Feature Development → Workflow Prompts: uses prompts (evidence: `README.md`)
- Bug Fix → Workflow Prompts: uses prompts (evidence: `README.md`)
- Refactor → Workflow Prompts: uses prompts (evidence: `README.md`)
- Incident → Workflow Prompts: uses prompts (evidence: `README.md`)
- Workflow Prompts → Recovery Prompts: catalogs recovery (evidence: `README.md`)
- Human → Specs and Plans: approves plan (evidence: `README.md`)
- Human → Feature Development: triages findings (evidence: `README.md`)
- AI Tool → Verification Contract: runs verification (evidence: `README.md`)
- Human → Verification Contract: runs verification (evidence: `README.md`)
- Workspace Health → AI Tool: reports workspace health (evidence: `README.md`)
- Adapter Installer → Claude Code Adapter: installs adapter (evidence: `README.md`)
- Adapter Installer → GitHub Copilot Adapter: installs adapter (evidence: `README.md`)
- Adapter Installer → Cursor Adapter: installs adapter (evidence: `README.md`)
- Adapter Installer → Generic Adapter: installs adapter (evidence: `README.md`)
- AI Tool → Agent Signpost: loads context (evidence: `README.md`)
- Project Context → Decision Records: includes ADRs (evidence: `README.md`)
