# engindemirog/ai-native-engineering-workspace architecture

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

- Interactive diagram: https://gitdiagram.com/engindemirog/ai-native-engineering-workspace
- Repository: https://github.com/engindemirog/ai-native-engineering-workspace

## Overview

ANEW is a technology-agnostic, file-based engineering workspace for directing AI-assisted software work. A user invokes a tool adapter or uses prompts directly; the agent follows workflow segments that clarify intent, create and approve a spec and plan, build, undergo independent review, and verify against evidence before a human decides to ship. Specs, plans, project guidance, and decisions preserve process memory. The documented quality tools check the workspace and run its configured verification contract. Relationships reflect README-documented responsibilities; source excerpts were unavailable, so uncertain internal wiring is omitted.

Main entry points: [`adapters`](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/adapters) (Tool adapters), [`workflows`](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/workflows) (Workflow definitions), [`scripts/doctor`](https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/doctor) (Workspace health), [`specs`](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/specs) (Specs and plans)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core guidance"]
  node_agents["Agent signpost<br/>[AGENTS.md]"]
  node_docs["Project memory"]
  node_roles["Role cards"]
end

subgraph group_lifecycle["Work lifecycle"]
  node_specs["Specs and plans"]
  node_workflows["Workflow definitions"]
  node_segments["Feature segments<br/>[segments.md]"]
  node_prompts["Prompt library"]
  node_recovery["Recovery prompts"]
end

subgraph group_interfaces["Tool interfaces"]
  node_adapters["Tool adapters"]
  node_init["Adapter installer"]
end

subgraph group_quality["Quality gates"]
  node_check["Verification contract"]
  node_checkconf["Check configuration<br/>[check.conf.example]"]
  node_doctor["Workspace health"]
end

node_human(("Engineer"))
node_agent(("AI agent"))
node_project["Project code"]

node_human -->|"invokes commands"| node_adapters
node_human -.->|"pastes prompts"| node_prompts
node_adapters -->|"maps commands"| node_segments
node_adapters -->|"exposes prompts"| node_prompts
node_human -->|"directs work"| node_agent
node_agent -->|"loads context"| node_agents
node_agent -->|"follows process"| node_workflows
node_workflows -->|"defines stages"| node_segments
node_workflows -->|"points to prompts"| node_prompts
node_agent -->|"uses role guidance"| node_roles
node_agent -->|"writes work records"| node_specs
node_human -->|"approves gates"| node_specs
node_agent -->|"implements plan"| node_project
node_agent -->|"runs verification"| node_check
node_check -->|"reads settings"| node_checkconf
node_doctor -->|"checks gate consistency"| node_specs
node_doctor -->|"checks presence"| node_adapters
node_human -->|"checks workspace"| node_doctor
node_init -->|"installs adapter"| node_adapters
node_recovery -.->|"guides recovery"| node_agent
node_agent -->|"updates project memory"| node_docs

click node_agents "https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/AGENTS.md"
click node_docs "https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/docs"
click node_roles "https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/docs/roles"
click node_specs "https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/specs"
click node_workflows "https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/workflows"
click node_segments "https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/workflows/segments.md"
click node_prompts "https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/prompts"
click node_recovery "https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/prompts/recovery"
click node_adapters "https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/adapters"
click node_init "https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/init"
click node_check "https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/check"
click node_checkconf "https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/check.conf.example"
click node_doctor "https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/doctor"

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_agents,node_docs,node_roles toneBlue
class node_specs,node_workflows,node_segments,node_prompts,node_recovery toneAmber
class node_adapters,node_init toneMint
class node_check,node_checkconf,node_doctor toneRose
class node_human,node_agent,node_project toneIndigo
```

## Components

### Core guidance

- [Agent signpost](https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/AGENTS.md): `AGENTS.md`
- [Project memory](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/docs): `docs`
- [Role cards](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/docs/roles): `docs/roles`

### Work lifecycle

- [Specs and plans](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/specs): `specs`
- [Workflow definitions](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/workflows): `workflows`
- [Feature segments](https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/workflows/segments.md): `workflows/segments.md`
- [Prompt library](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/prompts): `prompts`
- [Recovery prompts](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/prompts/recovery): `prompts/recovery`

### Tool interfaces

- [Tool adapters](https://github.com/engindemirog/ai-native-engineering-workspace/tree/main/adapters): `adapters`
- [Adapter installer](https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/init): `scripts/init`

### Quality gates

- [Verification contract](https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/check): `scripts/check`
- [Check configuration](https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/check.conf.example): `scripts/check.conf.example`
- [Workspace health](https://github.com/engindemirog/ai-native-engineering-workspace/blob/main/scripts/doctor): `scripts/doctor`

### Other components

- **Engineer**
- **AI agent**
- **Project code**

## Connections

- Engineer → Tool adapters: invokes commands
- Engineer → Prompt library: pastes prompts
- Tool adapters → Feature segments: maps commands
- Tool adapters → Prompt library: exposes prompts
- Engineer → AI agent: directs work
- AI agent → Agent signpost: loads context
- AI agent → Workflow definitions: follows process
- Workflow definitions → Feature segments: defines stages
- Workflow definitions → Prompt library: points to prompts
- AI agent → Role cards: uses role guidance
- AI agent → Specs and plans: writes work records
- Engineer → Specs and plans: approves gates
- AI agent → Project code: implements plan
- AI agent → Verification contract: runs verification
- Verification contract → Check configuration: reads settings
- Workspace health → Specs and plans: checks gate consistency
- Workspace health → Tool adapters: checks presence
- Engineer → Workspace health: checks workspace
- Adapter installer → Tool adapters: installs adapter
- Recovery prompts → AI agent: guides recovery
- AI agent → Project memory: updates project memory