# tw93/waza architecture

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

- Interactive diagram: https://gitdiagram.com/tw93/waza
- Repository: https://github.com/tw93/waza

## Overview

Waza is a collection of engineering playbooks and helper scripts invoked by coding agents. A user selects a skill for planning, UI work, review, debugging, writing, research, source intake, or agent-setup audits; the skill guides work toward its outcome. README documents the skill capabilities and the general presence of helper scripts, but most skill documents are not in the supplied tree, so their internal orchestration is not mapped. The listed scripts are shown as capability-specific helpers, not as a presumed pipeline.

Main entry points: [`skills/health/SKILL.md`](https://github.com/tw93/waza/blob/main/skills/health/SKILL.md) (Health audits), [`skills/read/SKILL.md`](https://github.com/tw93/waza/blob/main/skills/read/SKILL.md) (Read sources), [`skills/check/SKILL.md`](https://github.com/tw93/waza/blob/main/skills/check/SKILL.md) (Check review), [`skills/write/SKILL.md`](https://github.com/tw93/waza/blob/main/skills/write/SKILL.md) (Write prose)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_playbooks["Engineering playbooks"]
  node_think["Think planning<br/>[SKILL.md]"]
  node_ui["UI building<br/>[SKILL.md]"]
  node_hunt["Hunt debugging<br/>[SKILL.md]"]
  node_learn["Learn research<br/>[SKILL.md]"]
end

subgraph group_review["Review and release"]
  node_check["Check review<br/>[SKILL.md]"]
  node_audit["Audit signals<br/>[audit_signals.py]"]
  node_ledger["Incident ledger<br/>[incident_ledger.py]"]
  node_release["Release gate<br/>[release_gate.py]"]
end

subgraph group_health["Agent health"]
  node_health["Health audits<br/>[SKILL.md]"]
  node_context["Agent context"]
  node_maintain["Maintainability"]
  node_conversation["Conversation audit"]
  node_security["Skill security"]
  node_pipeguard["Shell pipe guard"]
end

subgraph group_helpers["Read and writing tools"]
  node_read["Read sources<br/>[SKILL.md]"]
  node_local["Local fetch<br/>[fetch_local.py]"]
  node_feishu["Feishu fetch<br/>[fetch_feishu.py]"]
  node_weixin["Weixin fetch<br/>[fetch_weixin.py]"]
  node_deepseek["DeepSeek fetch<br/>[deepseek.py]"]
  node_write["Write prose<br/>[SKILL.md]"]
  node_punctuation["Punctuation check"]
end

node_user(("Engineer"))

node_user -->|"invokes"| node_think
node_user -->|"invokes"| node_ui
node_user -->|"invokes"| node_check
node_user -->|"invokes"| node_hunt
node_user -->|"invokes"| node_write
node_user -->|"invokes"| node_learn
node_user -->|"invokes"| node_read
node_user -->|"invokes"| node_health
node_check -.->|"may use"| node_audit
node_check -.->|"may use"| node_ledger
node_check -.->|"may use"| node_release
node_health -.->|"may use"| node_context
node_health -.->|"may use"| node_maintain
node_health -.->|"may use"| node_conversation
node_health -.->|"may use"| node_security
node_health -.->|"may use"| node_pipeguard
node_read -.->|"may use"| node_local
node_read -.->|"may use"| node_feishu
node_read -.->|"may use"| node_weixin
node_read -.->|"may use"| node_deepseek
node_write -.->|"may use"| node_punctuation

click node_think "https://github.com/tw93/waza/blob/main/skills/think/SKILL.md"
click node_ui "https://github.com/tw93/waza/blob/main/skills/ui/SKILL.md"
click node_hunt "https://github.com/tw93/waza/blob/main/skills/hunt/SKILL.md"
click node_learn "https://github.com/tw93/waza/blob/main/skills/learn/SKILL.md"
click node_check "https://github.com/tw93/waza/blob/main/skills/check/SKILL.md"
click node_audit "https://github.com/tw93/waza/blob/main/skills/check/scripts/audit_signals.py"
click node_ledger "https://github.com/tw93/waza/blob/main/skills/check/scripts/incident_ledger.py"
click node_release "https://github.com/tw93/waza/blob/main/skills/check/scripts/release_gate.py"
click node_health "https://github.com/tw93/waza/blob/main/skills/health/SKILL.md"
click node_context "https://github.com/tw93/waza/blob/main/skills/health/scripts/check_agent_context.py"
click node_maintain "https://github.com/tw93/waza/blob/main/skills/health/scripts/check_maintainability.py"
click node_conversation "https://github.com/tw93/waza/blob/main/skills/health/scripts/conversation_audit.py"
click node_security "https://github.com/tw93/waza/blob/main/skills/health/scripts/scan_skill_security.py"
click node_pipeguard "https://github.com/tw93/waza/blob/main/skills/health/scripts/block-pipe-to-shell.py"
click node_read "https://github.com/tw93/waza/blob/main/skills/read/SKILL.md"
click node_local "https://github.com/tw93/waza/blob/main/skills/read/scripts/fetch_local.py"
click node_feishu "https://github.com/tw93/waza/blob/main/skills/read/scripts/fetch_feishu.py"
click node_weixin "https://github.com/tw93/waza/blob/main/skills/read/scripts/fetch_weixin.py"
click node_deepseek "https://github.com/tw93/waza/blob/main/skills/read/scripts/deepseek.py"
click node_write "https://github.com/tw93/waza/blob/main/skills/write/SKILL.md"
click node_punctuation "https://github.com/tw93/waza/blob/main/skills/write/scripts/check_punctuation.py"

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_think,node_ui,node_hunt,node_learn toneBlue
class node_check,node_audit,node_ledger,node_release toneAmber
class node_health,node_context,node_maintain,node_conversation,node_security,node_pipeguard toneMint
class node_read,node_local,node_feishu,node_weixin,node_deepseek,node_write,node_punctuation toneRose
class node_user toneIndigo
```

## Components

### Engineering playbooks

- [Think planning](https://github.com/tw93/waza/blob/main/skills/think/SKILL.md): `skills/think/SKILL.md`
- [UI building](https://github.com/tw93/waza/blob/main/skills/ui/SKILL.md): `skills/ui/SKILL.md`
- [Hunt debugging](https://github.com/tw93/waza/blob/main/skills/hunt/SKILL.md): `skills/hunt/SKILL.md`
- [Learn research](https://github.com/tw93/waza/blob/main/skills/learn/SKILL.md): `skills/learn/SKILL.md`

### Review and release

- [Check review](https://github.com/tw93/waza/blob/main/skills/check/SKILL.md): `skills/check/SKILL.md`
- [Audit signals](https://github.com/tw93/waza/blob/main/skills/check/scripts/audit_signals.py): `skills/check/scripts/audit_signals.py`
- [Incident ledger](https://github.com/tw93/waza/blob/main/skills/check/scripts/incident_ledger.py): `skills/check/scripts/incident_ledger.py`
- [Release gate](https://github.com/tw93/waza/blob/main/skills/check/scripts/release_gate.py): `skills/check/scripts/release_gate.py`

### Agent health

- [Health audits](https://github.com/tw93/waza/blob/main/skills/health/SKILL.md): `skills/health/SKILL.md`
- [Agent context](https://github.com/tw93/waza/blob/main/skills/health/scripts/check_agent_context.py): `skills/health/scripts/check_agent_context.py`
- [Maintainability](https://github.com/tw93/waza/blob/main/skills/health/scripts/check_maintainability.py): `skills/health/scripts/check_maintainability.py`
- [Conversation audit](https://github.com/tw93/waza/blob/main/skills/health/scripts/conversation_audit.py): `skills/health/scripts/conversation_audit.py`
- [Skill security](https://github.com/tw93/waza/blob/main/skills/health/scripts/scan_skill_security.py): `skills/health/scripts/scan_skill_security.py`
- [Shell pipe guard](https://github.com/tw93/waza/blob/main/skills/health/scripts/block-pipe-to-shell.py): `skills/health/scripts/block-pipe-to-shell.py`

### Read and writing tools

- [Read sources](https://github.com/tw93/waza/blob/main/skills/read/SKILL.md): `skills/read/SKILL.md`
- [Local fetch](https://github.com/tw93/waza/blob/main/skills/read/scripts/fetch_local.py): `skills/read/scripts/fetch_local.py`
- [Feishu fetch](https://github.com/tw93/waza/blob/main/skills/read/scripts/fetch_feishu.py): `skills/read/scripts/fetch_feishu.py`
- [Weixin fetch](https://github.com/tw93/waza/blob/main/skills/read/scripts/fetch_weixin.py): `skills/read/scripts/fetch_weixin.py`
- [DeepSeek fetch](https://github.com/tw93/waza/blob/main/skills/read/scripts/deepseek.py): `skills/read/scripts/deepseek.py`
- [Write prose](https://github.com/tw93/waza/blob/main/skills/write/SKILL.md): `skills/write/SKILL.md`
- [Punctuation check](https://github.com/tw93/waza/blob/main/skills/write/scripts/check_punctuation.py): `skills/write/scripts/check_punctuation.py`

### Other components

- **Engineer**

## Connections

- Engineer → Think planning: invokes (evidence: `README.md`)
- Engineer → UI building: invokes (evidence: `README.md`)
- Engineer → Check review: invokes (evidence: `README.md`)
- Engineer → Hunt debugging: invokes (evidence: `README.md`)
- Engineer → Write prose: invokes (evidence: `README.md`)
- Engineer → Learn research: invokes (evidence: `README.md`)
- Engineer → Read sources: invokes (evidence: `README.md`)
- Engineer → Health audits: invokes (evidence: `README.md`)
- Check review → Audit signals: may use
- Check review → Incident ledger: may use
- Check review → Release gate: may use
- Health audits → Agent context: may use
- Health audits → Maintainability: may use
- Health audits → Conversation audit: may use
- Health audits → Skill security: may use
- Health audits → Shell pipe guard: may use
- Read sources → Local fetch: may use
- Read sources → Feishu fetch: may use
- Read sources → Weixin fetch: may use
- Read sources → DeepSeek fetch: may use
- Write prose → Punctuation check: may use
