company-skill 4.0.0 → 4.1.0
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 +95 -85
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,91 +1,135 @@
|
|
|
1
|
-
#
|
|
1
|
+
# /company
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://www.npmjs.com/package/company-skill) [](LICENSE) [](https://www.npmjs.com/package/company-skill)
|
|
4
|
+
|
|
5
|
+
**Define your team in markdown. Give it a goal. Walk away.**
|
|
6
|
+
|
|
7
|
+
A Claude Code skill that runs your entire company — CEO delegates, departments execute in parallel, built-in reviewers verify — and doesn't stop until the goal is done.
|
|
4
8
|
|
|
5
9
|
```
|
|
6
10
|
/company "Build the user auth system with OAuth2"
|
|
7
11
|
```
|
|
8
12
|
|
|
9
|
-
|
|
13
|
+
## Why /company
|
|
14
|
+
|
|
15
|
+
| | Without /company | With /company |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| Task routing | You manually prompt each agent | CEO reads the goal, picks relevant employees, delegates |
|
|
18
|
+
| Quality gates | Hope it's correct | Reviewer + Devil's Advocate + Elegance Enforcer triple-check |
|
|
19
|
+
| Knowledge retention | Lost every session | Playbook accumulates what worked, what failed, what's faster |
|
|
20
|
+
| Parallelism | One agent at a time | All departments run in parallel |
|
|
21
|
+
| Stopping condition | You decide when it's done | criteria.json blocks exit until ALL criteria pass |
|
|
10
22
|
|
|
11
|
-
##
|
|
23
|
+
## Quick Start
|
|
12
24
|
|
|
25
|
+
**1. Install**
|
|
13
26
|
```bash
|
|
14
27
|
npx company-skill install
|
|
15
28
|
```
|
|
16
29
|
|
|
17
|
-
|
|
18
|
-
```
|
|
19
|
-
|
|
30
|
+
**2. Define your team** (optional — a minimal company is created automatically)
|
|
31
|
+
```markdown
|
|
32
|
+
## Engineering
|
|
33
|
+
- Backend Lead, API design and database architecture
|
|
34
|
+
- Frontend Dev, React components and state management
|
|
35
|
+
|
|
36
|
+
## Research
|
|
37
|
+
- ML Scientist, model experiments and benchmarks
|
|
20
38
|
```
|
|
21
39
|
|
|
22
|
-
|
|
40
|
+
**3. Run**
|
|
41
|
+
```
|
|
42
|
+
/company "Build a REST API for user management with tests"
|
|
43
|
+
```
|
|
23
44
|
|
|
24
45
|
## How It Works
|
|
25
46
|
|
|
47
|
+
```mermaid
|
|
48
|
+
graph LR
|
|
49
|
+
G[GOAL] --> T[THINK]
|
|
50
|
+
T -->|Opus: CEO + leads assign tasks| E[EXECUTE]
|
|
51
|
+
E -->|Sonnet: workers do the work| V[VERIFY]
|
|
52
|
+
V -->|Opus: Reviewer + Advocate| D{Done?}
|
|
53
|
+
D -->|NO: feedback| T
|
|
54
|
+
D -->|YES| S[STATUS.md]
|
|
26
55
|
```
|
|
27
|
-
GOAL: "Build the auth system"
|
|
28
56
|
|
|
29
|
-
|
|
30
|
-
EXECUTE Employees do the work, use installed skills
|
|
31
|
-
VERIFY Reviewer checks criteria.json, Advocate attacks results
|
|
57
|
+
The loop does NOT stop until the Reviewer confirms all criteria pass AND the Devil's Advocate accepts. There is no iteration limit.
|
|
32
58
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
59
|
+
<details>
|
|
60
|
+
<summary><strong>THINK</strong> — CEO picks relevant employees, leads assign tasks</summary>
|
|
61
|
+
|
|
62
|
+
The CEO reads the goal and COMPANY.md, decides which departments and employees are relevant (a mobile app goal doesn't need a Topologist), writes an active roster, then launches all department leads in parallel. Each lead assigns tasks to their employees with one sentence, one skill, and context.
|
|
63
|
+
|
|
64
|
+
If a lead sees a skill gap, they write `HIRE: {role}, {why}` and the CEO adds it to the team.
|
|
65
|
+
</details>
|
|
36
66
|
|
|
37
|
-
|
|
67
|
+
<details>
|
|
68
|
+
<summary><strong>EXECUTE</strong> — All workers run in parallel with installed skills</summary>
|
|
69
|
+
|
|
70
|
+
Every employee gets their task, previous findings, and failed approaches from the playbook. Every finding must have a source — file path, URL, or command output. Novel ideas use "NOVEL — needs validation" and the reviewer adds a validation criterion. No source = rejected.
|
|
71
|
+
</details>
|
|
72
|
+
|
|
73
|
+
<details>
|
|
74
|
+
<summary><strong>VERIFY</strong> — Triple quality gate blocks premature completion</summary>
|
|
75
|
+
|
|
76
|
+
**Internal Reviewer** checks each criterion in criteria.json against evidence. No evidence? Stays `false`.
|
|
77
|
+
|
|
78
|
+
**Devil's Advocate** attacks anything marked as passing. "Is this actually complete or surface-level? What edge cases were missed?"
|
|
79
|
+
|
|
80
|
+
**Elegance Enforcer** asks "Can this be simpler? Does every component justify its existence?"
|
|
81
|
+
|
|
82
|
+
All three must accept before the loop exits.
|
|
83
|
+
</details>
|
|
38
84
|
|
|
39
85
|
## Goal Enforcement
|
|
40
86
|
|
|
41
|
-
The skill creates `criteria.json` with checkable success criteria:
|
|
87
|
+
The skill creates `criteria.json` with machine-checkable success criteria:
|
|
42
88
|
|
|
43
89
|
```json
|
|
44
|
-
{"goal":"Build auth","criteria":[
|
|
45
|
-
{"id":1,"description":"OAuth2 login works with Google","passes":false,"evidence":null},
|
|
46
|
-
{"id":2,"description":"All tests pass","passes":false,"evidence":null}
|
|
90
|
+
{"goal": "Build auth", "criteria": [
|
|
91
|
+
{"id": 1, "description": "OAuth2 login works with Google", "passes": false, "evidence": null},
|
|
92
|
+
{"id": 2, "description": "All tests pass", "passes": false, "evidence": null}
|
|
47
93
|
]}
|
|
48
94
|
```
|
|
49
95
|
|
|
50
|
-
|
|
96
|
+
A Stop Hook reads this file and **blocks Claude from exiting** until every criterion passes. To cancel: `touch .company/CANCEL`.
|
|
51
97
|
|
|
52
|
-
## Self-
|
|
98
|
+
## Self-Improving Playbook
|
|
53
99
|
|
|
54
100
|
One file: `.company/playbook.md`. Accumulates across sessions.
|
|
55
101
|
|
|
56
|
-
After each session, the CEO writes
|
|
57
|
-
- WORKED: what succeeded (with evidence)
|
|
58
|
-
- FAILED: what failed, USE INSTEAD: what works, WHY: the difference
|
|
59
|
-
- INEFFICIENT: what was slow, FASTER: better approach
|
|
60
|
-
- TOP: best employees for priority activation next time
|
|
61
|
-
- HIRE/FIRE: roles added or deactivated
|
|
102
|
+
After each session, the CEO writes what worked, what failed (and what to use instead), what was slow (and what's faster), which employees performed best, and which roles to hire or deactivate. Leads read the playbook before every THINK phase.
|
|
62
103
|
|
|
63
|
-
|
|
104
|
+
**The company that starts session 5 is smarter than session 1.**
|
|
64
105
|
|
|
65
|
-
The CEO also
|
|
106
|
+
The CEO also evolves COMPANY.md: tags `[inactive]` on zero-contribution roles, `[priority]` on top performers, and updates employee descriptions based on what they're actually good at.
|
|
66
107
|
|
|
67
108
|
## Built-In Roles
|
|
68
109
|
|
|
69
|
-
Every company gets these automatically:
|
|
110
|
+
Every company gets these automatically (deduplicated if you define them in COMPANY.md):
|
|
70
111
|
|
|
71
|
-
| Role | Phase |
|
|
72
|
-
|
|
73
|
-
| CEO | THINK |
|
|
74
|
-
| CTO | THINK | Technical decisions, architecture |
|
|
112
|
+
| Role | Phase | Purpose |
|
|
113
|
+
|------|-------|---------|
|
|
114
|
+
| CEO | THINK | Reads goal, picks relevant employees, resolves conflicts |
|
|
115
|
+
| CTO | THINK | Technical decisions, architecture review |
|
|
75
116
|
| Internal Reviewer | VERIFY | Checks criteria.json, rejects findings without sources |
|
|
76
|
-
| User Advocate | VERIFY |
|
|
77
|
-
| Devil's Advocate | VERIFY | Attacks results, finds holes |
|
|
78
|
-
| Elegance Enforcer | VERIFY | Prevents over-engineering |
|
|
117
|
+
| User Advocate | VERIFY | "Would a real user understand this?" |
|
|
118
|
+
| Devil's Advocate | VERIFY | Attacks results, finds holes, prevents false completion |
|
|
119
|
+
| Elegance Enforcer | VERIFY | Prevents over-engineering, kills unnecessary complexity |
|
|
79
120
|
|
|
80
|
-
|
|
121
|
+
A 2-person COMPANY.md (Backend Dev + Frontend Dev) automatically gets CEO + CTO + both devs + all 4 reviewers = **8 employees running**.
|
|
81
122
|
|
|
82
|
-
##
|
|
123
|
+
## Model Assignment
|
|
83
124
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
125
|
+
| Phase | Model | Who |
|
|
126
|
+
|-------|-------|-----|
|
|
127
|
+
| THINK | Opus | CEO, CTO, department leads |
|
|
128
|
+
| EXECUTE | Sonnet | Workers |
|
|
129
|
+
| VERIFY | Opus | All reviewers |
|
|
130
|
+
| COMPRESS | Haiku | Digest writer |
|
|
87
131
|
|
|
88
|
-
|
|
132
|
+
Override per employee: `- ML Scientist, experiments [opus]`
|
|
89
133
|
|
|
90
134
|
## Commands
|
|
91
135
|
|
|
@@ -97,66 +141,32 @@ No source = rejected by reviewer.
|
|
|
97
141
|
/company:resume Continue from last session
|
|
98
142
|
```
|
|
99
143
|
|
|
100
|
-
## Visual Indicators
|
|
101
|
-
|
|
102
|
-
```
|
|
103
|
-
════════════════════════════════════════════════
|
|
104
|
-
CYCLE 1 - THINK > EXECUTE > VERIFY
|
|
105
|
-
════════════════════════════════════════════════
|
|
106
|
-
|
|
107
|
-
CYCLE 1 VERDICT: NOT DONE
|
|
108
|
-
Missing validation of compression ratios
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
Employees show with colors: leads (cyan), workers (green), reviewers (yellow), digest (gray).
|
|
112
|
-
|
|
113
|
-
## Agents
|
|
114
|
-
|
|
115
|
-
| Agent | Phase | Color |
|
|
116
|
-
|-------|-------|-------|
|
|
117
|
-
| company-lead | THINK | Cyan |
|
|
118
|
-
| company-worker | EXECUTE | Green |
|
|
119
|
-
| company-reviewer | VERIFY | Yellow |
|
|
120
|
-
| company-critic | VERIFY | Yellow |
|
|
121
|
-
| company-digest | COMPRESS | Gray |
|
|
122
|
-
|
|
123
|
-
## Model Assignment
|
|
124
|
-
|
|
125
|
-
| Phase | Model | Who |
|
|
126
|
-
|-------|-------|-----|
|
|
127
|
-
| THINK | Opus | CEO, CTO, leads |
|
|
128
|
-
| EXECUTE | Sonnet | Workers |
|
|
129
|
-
| VERIFY | Opus | Reviewers |
|
|
130
|
-
| COMPRESS | Haiku | Digest writer |
|
|
131
|
-
|
|
132
|
-
Override per employee: `- ML Scientist, experiments [opus]`
|
|
133
|
-
|
|
134
144
|
## Installed Skills
|
|
135
145
|
|
|
136
|
-
Auto-installed on first run
|
|
146
|
+
Auto-installed on first run. When installed, employees MUST use them.
|
|
137
147
|
|
|
138
148
|
| Pack | What employees get |
|
|
139
149
|
|------|-------------------|
|
|
140
|
-
| gstack | /review, /ship, /qa, /investigate, /browse
|
|
141
|
-
| GSD | /gsd
|
|
150
|
+
| gstack | /review, /ship, /qa, /investigate, /browse |
|
|
151
|
+
| GSD | /gsd-plan-phase, /gsd-execute-phase, /gsd-verify-work, /gsd-debug |
|
|
142
152
|
| trailofbits | Security audit, vulnerability detection |
|
|
143
153
|
|
|
144
|
-
|
|
154
|
+
<details>
|
|
155
|
+
<summary>Install more skill packs</summary>
|
|
145
156
|
|
|
146
157
|
```
|
|
147
158
|
/plugin marketplace add obra/superpowers-marketplace
|
|
148
159
|
/plugin marketplace add wshobson/agents
|
|
149
160
|
/plugin marketplace add alirezarezvani/claude-skills
|
|
150
161
|
```
|
|
151
|
-
|
|
152
|
-
When installed, employees MUST use them.
|
|
162
|
+
</details>
|
|
153
163
|
|
|
154
164
|
## What Gets Created
|
|
155
165
|
|
|
156
166
|
```
|
|
157
167
|
.company/
|
|
158
168
|
criteria.json Machine-checkable goal state
|
|
159
|
-
playbook.md Accumulated lessons (self-improvement)
|
|
169
|
+
playbook.md Accumulated lessons (THE self-improvement file)
|
|
160
170
|
active-roster.md Employees activated for this goal
|
|
161
171
|
active-tasks.md Deduplicated task list
|
|
162
172
|
STATUS.md Final report
|