hool-cli 0.7.2 → 0.7.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -13,10 +13,10 @@ You'll be asked three questions:
|
|
|
13
13
|
2. **Project type** — web app, browser game, mobile, CLI tool, API, desktop, animation, or other
|
|
14
14
|
3. **Mode** — Interactive (you review spec/design/architecture) or Full-HOOL (fully autonomous)
|
|
15
15
|
|
|
16
|
-
Then open your AI coding tool and
|
|
16
|
+
Then open your AI coding tool and say:
|
|
17
17
|
|
|
18
18
|
```
|
|
19
|
-
|
|
19
|
+
Begin Phase 1: Brainstorm
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
## Install
|
|
@@ -35,7 +35,7 @@ npm update -g hool-cli
|
|
|
35
35
|
|
|
36
36
|
### `hool init`
|
|
37
37
|
|
|
38
|
-
Scaffold HOOL in the current directory. Creates phase directories, operations files, agent memory,
|
|
38
|
+
Scaffold HOOL in the current directory. Creates phase directories, operations files, agent memory, hooks, settings, skills, and platform instructions.
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
41
|
hool init
|
|
@@ -50,18 +50,18 @@ hool init --dir ./myapp --platform claude-code --type web-app --mode full-hool
|
|
|
50
50
|
|
|
51
51
|
### `hool onboard`
|
|
52
52
|
|
|
53
|
-
Onboard an existing codebase into HOOL. Scaffolds the full HOOL structure around your existing code (no files are touched), then sets up onboarding tasks for agents to reverse-engineer project docs.
|
|
53
|
+
Onboard an existing codebase into HOOL. Scaffolds the full HOOL structure around your existing code (no files are touched), then sets up 11 onboarding tasks for agents to reverse-engineer project docs.
|
|
54
54
|
|
|
55
55
|
```bash
|
|
56
56
|
hool onboard
|
|
57
57
|
hool onboard --dir ./myapp --platform claude-code --type web-app
|
|
58
58
|
```
|
|
59
59
|
|
|
60
|
-
If `.hool/` already exists,
|
|
60
|
+
If `.hool/` already exists, auto-detects and offers **re-onboard** — a lightweight path that only resets `current-phase.md` and prepends onboarding tasks to the task board, preserving all memory and phase docs.
|
|
61
61
|
|
|
62
62
|
### `hool status`
|
|
63
63
|
|
|
64
|
-
Show current phase, task
|
|
64
|
+
Show current phase, task progress bars, per-agent breakdown, bug count, inconsistencies, governor audit status, and human review status.
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
67
|
hool status
|
|
@@ -103,15 +103,35 @@ hool mode interactive # switch to interactive
|
|
|
103
103
|
| **Forensic** | Root cause analysis, bug triage, fix routing |
|
|
104
104
|
| **Governor** | Behavioral auditor, rule enforcement, corrective feedback |
|
|
105
105
|
|
|
106
|
-
The Product Lead is the only user-facing agent. All others are dispatched
|
|
106
|
+
The Product Lead is the only user-facing agent. All others are dispatched as independent CLI sessions with their own context windows, MCP access, and role-specific hooks.
|
|
107
|
+
|
|
108
|
+
## What Gets Created
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
your-project/
|
|
112
|
+
.hool/
|
|
113
|
+
phases/ # Phase docs (spec, design, architecture, LLDs, test plan)
|
|
114
|
+
operations/ # Live state (task board, bugs, issues, governor rules, logs)
|
|
115
|
+
memory/ # Per-agent memory (8 agents × 5 memory files each)
|
|
116
|
+
hooks/ # Platform hooks (context injection, governor triggers)
|
|
117
|
+
settings/ # Per-role settings (hooks, permissions)
|
|
118
|
+
checklists/ # Code review checklists
|
|
119
|
+
agents.json # Agent manifest
|
|
120
|
+
mcps.json # MCP manifest
|
|
121
|
+
.claude/
|
|
122
|
+
agents/ # Agent definitions (7 subagents)
|
|
123
|
+
skills/ # Phase skills (/brainstorm, /spec, /design, /architecture)
|
|
124
|
+
settings.json # Product Lead hooks
|
|
125
|
+
CLAUDE.md # Full orchestrator prompt (claude-code platform)
|
|
126
|
+
```
|
|
107
127
|
|
|
108
128
|
## Supported Platforms
|
|
109
129
|
|
|
110
130
|
| Platform | Instruction file | MCP support |
|
|
111
131
|
|----------|-----------------|-------------|
|
|
112
|
-
| Claude Code | `CLAUDE.md` | Full (auto-installs) |
|
|
113
|
-
| Cursor | `.cursor/rules/hool.mdc` | Full (auto-installs) |
|
|
114
|
-
| Generic |
|
|
132
|
+
| Claude Code | `CLAUDE.md` | Full (auto-installs to `~/.claude/mcp_servers.json`) |
|
|
133
|
+
| Cursor | `.cursor/rules/hool.mdc` | Full (auto-installs to `~/.cursor/mcp.json`) |
|
|
134
|
+
| Generic | `HOOL-INSTRUCTIONS.md` | Manual setup |
|
|
115
135
|
|
|
116
136
|
## Links
|
|
117
137
|
|