@adaptic/maestro 1.1.1 → 1.1.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.
|
@@ -263,13 +263,21 @@ Sections to rewrite:
|
|
|
263
263
|
- **## Operating Principles** -- Replace with the new principles. Use the same numbered-list format.
|
|
264
264
|
- **## Communication Rules** -- Adapt the autonomy model to the archetype. An executive-operator has broad autonomy; a compliance-officer escalates more. Rewrite the "sends autonomously" and "escalates" sections with the new agent's name and appropriate boundaries. Keep the Immediate Acknowledgement Rule, Document Sharing, and Logging subsections but replace the agent name throughout.
|
|
265
265
|
- **## People (Key Leadership)** -- Update the "That's you" line to the new agent. Keep other people entries unless the user indicated changes.
|
|
266
|
+
- **## Control Towers** -- Replace the 12 generic org-wide control towers with 8-10 towers scoped to the agent's specific role and domain. Each tower should reflect what this agent actually monitors and manages. Generate towers based on archetype:
|
|
267
|
+
- **executive-operator**: Keep the original 12 org-wide towers (they are appropriate for this archetype).
|
|
268
|
+
- **technical-leader**: Model/platform architecture, R&D strategy, engineering quality, platform delivery, infrastructure & scalability, security & compliance, performance & benchmarking, team growth, systems & automation, self-governance.
|
|
269
|
+
- **commercial-leader**: Pipeline management, partnership development, investor relations, market intelligence, revenue operations, competitive analysis, client success, commercial governance, systems & automation, self-governance.
|
|
270
|
+
- **compliance-officer**: Regulatory submissions, licence management, policy framework, audit readiness, risk register, cross-jurisdiction compliance, legal obligations, reporting & disclosure, systems & automation, self-governance.
|
|
271
|
+
- **product-leader**: Product roadmap, user research & insights, feature delivery, design system, product-market fit, metrics & analytics, cross-functional alignment, stakeholder communication, systems & automation, self-governance.
|
|
272
|
+
- **operations-leader**: Process efficiency, fund operations, vendor management, capacity planning, organisational design, SLA compliance, cost management, operational resilience, systems & automation, self-governance.
|
|
273
|
+
Each tower should have a brief description of what it monitors (same format as the original: `**Name** — description`).
|
|
266
274
|
|
|
267
275
|
Replace ALL instances of the old agent's first name with the new agent's first name throughout the entire CLAUDE.md file. Be thorough -- check every section header, bullet point, and inline reference.
|
|
268
276
|
|
|
269
277
|
Do NOT modify these sections (keep them exactly as they are, except for agent name substitution):
|
|
270
278
|
- Repository Layout, Key Config Files, Brand Assets, PDF Generation, Visual Media Generation
|
|
271
279
|
- Source Repositories, Hiring Management (unless archetype is not executive-operator, in which case trim or adapt)
|
|
272
|
-
- Operational Infrastructure
|
|
280
|
+
- Operational Infrastructure
|
|
273
281
|
- Build & Test, Code Standards, Three Operating Modes, Parallel Execution
|
|
274
282
|
- Agent Development, Workflow Development
|
|
275
283
|
|
package/README.md
CHANGED
|
@@ -23,9 +23,7 @@ The package provides: framework scripts (poller, daemon, triggers, hooks, PDF an
|
|
|
23
23
|
```bash
|
|
24
24
|
npx @adaptic/maestro create jacob-ai
|
|
25
25
|
cd jacob-ai
|
|
26
|
-
|
|
27
|
-
npm run init-agent # Create directories, install launchd agents, configure Claude Code
|
|
28
|
-
claude "/init-maestro" # Interactive identity and services wizard
|
|
26
|
+
claude "/init-maestro" # Handles everything: setup, identity, services, launchd
|
|
29
27
|
```
|
|
30
28
|
|
|
31
29
|
### Prerequisites
|
|
@@ -92,11 +90,14 @@ Scaffolds a new agent repository. This command:
|
|
|
92
90
|
2. Copies all framework files (scripts, agents, workflows, policies, plugins, docs)
|
|
93
91
|
3. Copies scaffold templates (CLAUDE.md and config/agent.ts stubs)
|
|
94
92
|
4. Copies `.claude/` directory (settings and commands)
|
|
95
|
-
5. Creates
|
|
96
|
-
6. Generates
|
|
97
|
-
7.
|
|
98
|
-
8.
|
|
99
|
-
9.
|
|
93
|
+
5. Creates 57 agent-specific directories (config, knowledge, memory, state, logs, outputs, self-optimization, tests)
|
|
94
|
+
6. Generates 53 operational template files (16 queues, 10 dashboards, 13 configs, 9 knowledge schemas, 5 self-optimization)
|
|
95
|
+
7. Generates a `package.json` with all required scripts and dependencies
|
|
96
|
+
8. Copies `.env.example` and `.gitignore`
|
|
97
|
+
9. Initializes a git repository
|
|
98
|
+
10. Runs `npm install`
|
|
99
|
+
|
|
100
|
+
After `create`, run `claude "/init-maestro"` to configure the agent's identity and bring it online. The wizard handles system bootstrap, identity configuration, service setup, launchd installation, and verification -- no other setup commands are needed.
|
|
100
101
|
|
|
101
102
|
### `npx @adaptic/maestro upgrade`
|
|
102
103
|
|
|
@@ -106,19 +107,25 @@ Updates framework files in an existing agent repo. This command copies the lates
|
|
|
106
107
|
- `policies/` -- action classification, information barriers, prompt injection defence
|
|
107
108
|
- `docs/` -- architecture, governance, runbooks
|
|
108
109
|
- `public/assets/` -- brand assets
|
|
110
|
+
- `workflows/`, `schedules/`, `teams/`, `desktop-control/`, `ingest/`, `mcp/`
|
|
109
111
|
- `.claude/commands/` -- slash commands
|
|
110
112
|
- `plugins/maestro-skills/` -- operational skills
|
|
113
|
+
- `agents/` -- new agents are added, existing ones preserved (no deletions)
|
|
114
|
+
|
|
115
|
+
It also creates any missing directories from the expanded directory set.
|
|
111
116
|
|
|
112
117
|
Agent-specific files (`config/`, `CLAUDE.md`, `knowledge/`, `memory/`, `state/`, `logs/`) are never touched.
|
|
113
118
|
|
|
114
119
|
### `npx @adaptic/maestro doctor`
|
|
115
120
|
|
|
116
|
-
Verifies the agent installation. Checks for:
|
|
121
|
+
Verifies the agent installation. Checks for 16 essential files:
|
|
117
122
|
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
- `
|
|
121
|
-
-
|
|
123
|
+
- Core: `config/agent.ts`, `CLAUDE.md`, `.claude/settings.json`, `.claude/commands/init-maestro.md`, `package.json`
|
|
124
|
+
- Setup: `scripts/setup/init-agent.sh`, `scripts/healthcheck.sh`, `scripts/daemon/maestro-daemon.mjs`, `scripts/local-triggers/generate-plists.sh`
|
|
125
|
+
- Config: `config/environment.yaml`, `config/contacts.yaml`, `config/priorities.yaml`, `config/sla-defaults.yaml`
|
|
126
|
+
- State: `state/dashboards/executive-summary.yaml`, `state/queues/action-stack.yaml`, `knowledge/decisions/decision-schema.yaml`
|
|
127
|
+
- Environment: `.env` file with `ANTHROPIC_API_KEY` (required), `SLACK_USER_TOKEN`, `GMAIL_APP_PASSWORD` (optional)
|
|
128
|
+
- Dependencies: `node_modules` installed, Claude CLI available
|
|
122
129
|
|
|
123
130
|
---
|
|
124
131
|
|
|
@@ -137,17 +144,18 @@ The `upgrade` command only updates framework infrastructure: scripts, policies,
|
|
|
137
144
|
|
|
138
145
|
## The /init-maestro Wizard
|
|
139
146
|
|
|
140
|
-
After scaffolding, run `claude "/init-maestro"` to configure your agent
|
|
141
|
-
|
|
142
|
-
1. **Identity gathering** -- Prompts for agent name, surname, title, archetype, email, phone, Mac mini hostname, principal (reporting line), responsibilities, communication style, and operating principles.
|
|
143
|
-
|
|
144
|
-
2. **Parallel file rewriting** -- Rewrites `config/agent.ts` with structured identity data, generates `CLAUDE.md` with the full behavioural charter, updates `config/environment.yaml` with paths and schedule, and adapts `schedules/triggers/*.md` with the new identity.
|
|
145
|
-
|
|
146
|
-
3. **macOS configuration** -- Updates launchd plist labels and paths, sets `package.json` name and description, and configures script variables.
|
|
147
|
-
|
|
148
|
-
4. **Third-party services** -- Walks through Slack, Gmail, Calendar, and optional integrations, writing credentials to `.env`.
|
|
147
|
+
After scaffolding, run `claude "/init-maestro"` to configure your agent. This is the only command you need -- it handles everything from system setup to identity configuration to bringing the agent online. The wizard runs in eight phases:
|
|
149
148
|
|
|
150
|
-
|
|
149
|
+
| Phase | What it does |
|
|
150
|
+
|-------|-------------|
|
|
151
|
+
| **0. System Bootstrap** | Checks prerequisites (Node.js, npm, Claude CLI, jq), runs `npm install`, creates directories, installs global Claude Code settings, creates `.env` from template |
|
|
152
|
+
| **1. Identity Gathering** | Prompts for agent name, surname, title, archetype, email, phone, Mac mini hostname, principal (reporting line), responsibilities, communication style, operating principles |
|
|
153
|
+
| **2. Parallel Rewrite** | 8 sub-agents rewrite the repo in parallel: `config/agent.ts`, `CLAUDE.md`, config files, `package.json`, scripts, agent definitions, triggers/workflows, and agent-specific tools/skills |
|
|
154
|
+
| **3. Machine Config** | Generates launchd plists with the correct agent name, installs them, optionally configures macOS for headless 24/7 operation |
|
|
155
|
+
| **4. Service Setup** | Walks through Slack, Gmail, Twilio, Cloudflare, voice integration -- writing credentials to `.env` |
|
|
156
|
+
| **5. README** | Generates an agent-specific README.md |
|
|
157
|
+
| **6. GitHub Repo** | Optionally creates a GitHub repository and pushes the initial commit |
|
|
158
|
+
| **7. Verification** | Greps for stale references, validates `config/agent.ts`, runs healthcheck, prints summary |
|
|
151
159
|
|
|
152
160
|
See [docs/guides/agent-persona-setup.md](docs/guides/agent-persona-setup.md) for the full persona configuration guide, including archetype defaults, Control Tower selection, contact classification, and manual fine-tuning.
|
|
153
161
|
|
|
@@ -173,7 +181,7 @@ Additional services are available via MCP servers and can be configured separate
|
|
|
173
181
|
|
|
174
182
|
### Environment Variables
|
|
175
183
|
|
|
176
|
-
|
|
184
|
+
The `/init-maestro` wizard creates the `.env` file and walks you through filling in credentials. Key variables:
|
|
177
185
|
|
|
178
186
|
```bash
|
|
179
187
|
# Core
|
|
@@ -597,4 +597,4 @@ The 5-layer defence is universal and should not be weakened. The only customisat
|
|
|
597
597
|
| `memory/profiles/channels/` | Channel tone and rules | Low | Builds up over time through interaction |
|
|
598
598
|
| `config/brand-assets.yaml` | Usually unchanged | Low | Only change if agent serves a different brand |
|
|
599
599
|
| `package.json` | Name and description | Low | Update to reflect new agent identity |
|
|
600
|
-
| `scripts/local-triggers/plists/` | Launchd labels and paths | Low | Handled by `
|
|
600
|
+
| `scripts/local-triggers/plists/` | Launchd labels and paths | Low | Handled by `/init-maestro` Phase 3 (generate-plists.sh) |
|