workspace-maxxing 0.2.0 → 0.3.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 +52 -42
- package/dist/index.js +46 -22
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/src/index.ts +52 -22
- package/workspace/00-meta/CONTEXT.md +0 -3
- package/workspace/00-meta/execution-log.md +0 -17
- package/workspace/00-meta/tools.md +0 -11
- package/workspace/01-input/CONTEXT.md +0 -27
- package/workspace/CONTEXT.md +0 -35
- package/workspace/README.md +0 -14
- package/workspace/SYSTEM.md +0 -36
- package/workspace-maxxing-0.1.0.tgz +0 -0
package/README.md
CHANGED
|
@@ -16,68 +16,78 @@ Most agent workspaces drift over time because prompts are underspecified and con
|
|
|
16
16
|
- **Create invokable agents** - the skill can build autonomous agents that can be invoked with `@` in your workspace
|
|
17
17
|
- **Self-improving agents** - created agents run through iteration loops to ensure robustness
|
|
18
18
|
|
|
19
|
-
##
|
|
20
|
-
|
|
21
|
-
- Node.js 18+
|
|
22
|
-
- `npx` available in your shell
|
|
19
|
+
## Quick Start
|
|
23
20
|
|
|
24
|
-
|
|
21
|
+
### One Command Does Everything
|
|
25
22
|
|
|
26
23
|
```bash
|
|
27
|
-
#
|
|
24
|
+
# Create workspace with agent (recommended)
|
|
25
|
+
npx workspace-maxxing init
|
|
26
|
+
|
|
27
|
+
# Install skill to OpenCode
|
|
28
|
+
npx workspace-maxxing install
|
|
29
|
+
|
|
30
|
+
# Or use the old way (still works)
|
|
28
31
|
npx workspace-maxxing --opencode
|
|
32
|
+
```
|
|
29
33
|
|
|
30
|
-
|
|
31
|
-
npx workspace-maxxing --claude
|
|
34
|
+
That's it! No extra flags needed.
|
|
32
35
|
|
|
33
|
-
|
|
34
|
-
npx workspace-maxxing --copilot
|
|
36
|
+
## Two Main Use Cases
|
|
35
37
|
|
|
36
|
-
|
|
37
|
-
npx workspace-maxxing --gemini
|
|
38
|
-
```
|
|
38
|
+
### Use Case 1: Create a New Workspace with Agent
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
When you want to start a new workflow project:
|
|
41
41
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
| Claude Code | `--claude` | `.claude/skills/` |
|
|
46
|
-
| GitHub Copilot | `--copilot` | `.github/copilot-instructions/` |
|
|
47
|
-
| Gemini CLI | `--gemini` | `.gemini/skills/` |
|
|
42
|
+
```bash
|
|
43
|
+
# Basic (creates "My Workspace" with 3 stages)
|
|
44
|
+
npx workspace-maxxing init
|
|
48
45
|
|
|
49
|
-
|
|
46
|
+
# Custom name
|
|
47
|
+
npx workspace-maxxing init --workspace-name "Daily Digest"
|
|
50
48
|
|
|
51
|
-
|
|
49
|
+
# Custom stages
|
|
50
|
+
npx workspace-maxxing init --stages "01-input,02-process,03-output,04-deploy"
|
|
52
51
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
3. Invoke the `workspace-maxxing` skill.
|
|
56
|
-
4. Approve the proposed workflow structure.
|
|
57
|
-
5. Let the agent scaffold, validate, and iterate until quality gates pass.
|
|
52
|
+
# Without agent (backward compatible)
|
|
53
|
+
npx workspace-maxxing init --no-agent
|
|
58
54
|
|
|
59
|
-
|
|
55
|
+
# To specific folder
|
|
56
|
+
npx workspace-maxxing init --output "./my-workspace"
|
|
57
|
+
```
|
|
60
58
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
59
|
+
This creates:
|
|
60
|
+
- ICM workspace folder structure
|
|
61
|
+
- Invokable `@agent` in `.agents/skills/`
|
|
62
|
+
- Runs self-improvement loop (score >= 85)
|
|
64
63
|
|
|
65
|
-
|
|
66
|
-
npx workspace-maxxing --create-workspace --workspace-name "My Workflow" --no-agent
|
|
64
|
+
### Use Case 2: Install the Skill to Your Project
|
|
67
65
|
|
|
68
|
-
|
|
69
|
-
|
|
66
|
+
When you want to use workspace-maxxing as a skill in your AI agent:
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
# Install to current project (OpenCode)
|
|
70
|
+
npx workspace-maxxing install
|
|
70
71
|
|
|
71
|
-
#
|
|
72
|
-
npx workspace-maxxing --
|
|
72
|
+
# Install to specific platform
|
|
73
|
+
npx workspace-maxxing --opencode
|
|
74
|
+
npx workspace-maxxing --claude
|
|
75
|
+
npx workspace-maxxing --copilot
|
|
76
|
+
npx workspace-maxxing --gemini
|
|
73
77
|
```
|
|
74
78
|
|
|
75
|
-
|
|
79
|
+
This installs the skill to `.agents/skills/workspace-maxxing/` so you can invoke it in your AI agent session with `@workspace-maxxing`.
|
|
80
|
+
|
|
81
|
+
## CLI Options
|
|
76
82
|
|
|
77
|
-
| Option |
|
|
78
|
-
|
|
79
|
-
|
|
|
80
|
-
|
|
|
83
|
+
| Option | Description |
|
|
84
|
+
|--------|-------------|
|
|
85
|
+
| `init` | Create workspace with agent (default command) |
|
|
86
|
+
| `install` | Install skill to current project |
|
|
87
|
+
| `--workspace-name` | Name of the workspace |
|
|
88
|
+
| `--stages` | Comma-separated stages |
|
|
89
|
+
| `--output` | Output directory |
|
|
90
|
+
| `--no-agent` | Create workspace without agent |
|
|
81
91
|
| `--stages` | "01-input,02-process,03-output" | Comma-separated stage names |
|
|
82
92
|
| `--output` | "./workspace" | Output directory |
|
|
83
93
|
| `--agent-name` | auto-generated (@workspace-name) | Custom agent name |
|
package/dist/index.js
CHANGED
|
@@ -45,13 +45,17 @@ function showHelp() {
|
|
|
45
45
|
workspace-maxxing — npx-installable skill for AI agents
|
|
46
46
|
|
|
47
47
|
Usage:
|
|
48
|
-
npx workspace-maxxing [
|
|
48
|
+
npx workspace-maxxing [command]
|
|
49
|
+
|
|
50
|
+
Commands (no flags needed):
|
|
51
|
+
init Create a new workspace with invokable agent (default)
|
|
52
|
+
install Install the skill to current project (for OpenCode)
|
|
49
53
|
|
|
50
54
|
Installation Options:
|
|
51
|
-
--opencode
|
|
52
|
-
--claude
|
|
53
|
-
--copilot
|
|
54
|
-
--gemini
|
|
55
|
+
--opencode Install skill for OpenCode agents
|
|
56
|
+
--claude Install skill for Claude Code agents
|
|
57
|
+
--copilot Install skill for GitHub Copilot agents
|
|
58
|
+
--gemini Install skill for Gemini CLI agents
|
|
55
59
|
|
|
56
60
|
Workspace Creation Options:
|
|
57
61
|
--create-workspace Create a new workspace with agent
|
|
@@ -64,20 +68,18 @@ Workspace Creation Options:
|
|
|
64
68
|
--max-iterations <n> Max agent iterations (default: 3)
|
|
65
69
|
|
|
66
70
|
Examples:
|
|
67
|
-
#
|
|
68
|
-
npx workspace-maxxing
|
|
69
|
-
|
|
70
|
-
# Create workspace with agent
|
|
71
|
-
npx workspace-maxxing --create-workspace --workspace-name "Daily Digest" --stages "01-input,02-process,03-output"
|
|
71
|
+
# Create workspace with agent (recommended)
|
|
72
|
+
npx workspace-maxxing init
|
|
72
73
|
|
|
73
|
-
# Create workspace
|
|
74
|
-
npx workspace-maxxing
|
|
74
|
+
# Create workspace with custom name
|
|
75
|
+
npx workspace-maxxing init --workspace-name "Daily Digest"
|
|
75
76
|
|
|
76
77
|
# Create workspace without agent
|
|
77
|
-
npx workspace-maxxing
|
|
78
|
+
npx workspace-maxxing init --no-agent
|
|
78
79
|
|
|
79
|
-
#
|
|
80
|
-
npx workspace-maxxing
|
|
80
|
+
# Install skill to OpenCode
|
|
81
|
+
npx workspace-maxxing install
|
|
82
|
+
npx workspace-maxxing --opencode
|
|
81
83
|
`);
|
|
82
84
|
}
|
|
83
85
|
function extractOption(args, option) {
|
|
@@ -158,12 +160,35 @@ async function main() {
|
|
|
158
160
|
showHelp();
|
|
159
161
|
process.exit(0);
|
|
160
162
|
}
|
|
161
|
-
// Check for workspace
|
|
162
|
-
if (args.includes('--create-workspace')) {
|
|
163
|
-
|
|
163
|
+
// Check for init command (create workspace with agent)
|
|
164
|
+
if (args.includes('init') || args.includes('--create-workspace')) {
|
|
165
|
+
// Remove 'init' from args if present, keep other flags
|
|
166
|
+
const cleanArgs = args.filter(a => a !== 'init' && a !== '--create-workspace');
|
|
167
|
+
await createWorkspace(cleanArgs);
|
|
164
168
|
return;
|
|
165
169
|
}
|
|
166
|
-
// Check for install
|
|
170
|
+
// Check for install command
|
|
171
|
+
if (args.includes('install')) {
|
|
172
|
+
const cwd = process.cwd();
|
|
173
|
+
const projectRoot = (0, install_1.detectProjectRoot)(cwd);
|
|
174
|
+
if (projectRoot !== cwd) {
|
|
175
|
+
console.log(`Detected project root: ${projectRoot}`);
|
|
176
|
+
}
|
|
177
|
+
const templatesDir = process.env.WORKSPACE_MAXXING_TEMPLATES ??
|
|
178
|
+
path.join(__dirname, '..', 'templates');
|
|
179
|
+
console.log(`Installing workspace-maxxing skill...`);
|
|
180
|
+
const result = await (0, install_1.installSkill)(projectRoot, templatesDir, 'opencode');
|
|
181
|
+
if (result.success) {
|
|
182
|
+
console.log(`Skill installed to: ${result.skillPath}`);
|
|
183
|
+
console.log(`Open a new OpenCode session and invoke the workspace-maxxing skill to get started.`);
|
|
184
|
+
}
|
|
185
|
+
else {
|
|
186
|
+
console.error(`Installation failed: ${result.error}`);
|
|
187
|
+
process.exit(1);
|
|
188
|
+
}
|
|
189
|
+
return;
|
|
190
|
+
}
|
|
191
|
+
// Check for install targets (--opencode, --claude, etc.)
|
|
167
192
|
const agentFlags = ['opencode', 'claude', 'copilot', 'gemini'];
|
|
168
193
|
const detectedAgent = agentFlags.find((flag) => args.includes(`--${flag}`));
|
|
169
194
|
if (detectedAgent) {
|
|
@@ -186,9 +211,8 @@ async function main() {
|
|
|
186
211
|
}
|
|
187
212
|
return;
|
|
188
213
|
}
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
process.exit(1);
|
|
214
|
+
// Default: treat as workspace creation (backward compatible)
|
|
215
|
+
await createWorkspace(args);
|
|
192
216
|
}
|
|
193
217
|
main().catch((error) => {
|
|
194
218
|
console.error(error);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,2CAA6B;AAC7B,uCAAyE;AACzE,iDAAuD;AACvD,mDAA+E;AAC/E,qDAAgD;AAChD,2CAAmE;AAEnE,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/src/index.ts
CHANGED
|
@@ -12,13 +12,17 @@ function showHelp(): void {
|
|
|
12
12
|
workspace-maxxing — npx-installable skill for AI agents
|
|
13
13
|
|
|
14
14
|
Usage:
|
|
15
|
-
npx workspace-maxxing [
|
|
15
|
+
npx workspace-maxxing [command]
|
|
16
|
+
|
|
17
|
+
Commands (no flags needed):
|
|
18
|
+
init Create a new workspace with invokable agent (default)
|
|
19
|
+
install Install the skill to current project (for OpenCode)
|
|
16
20
|
|
|
17
21
|
Installation Options:
|
|
18
|
-
--opencode
|
|
19
|
-
--claude
|
|
20
|
-
--copilot
|
|
21
|
-
--gemini
|
|
22
|
+
--opencode Install skill for OpenCode agents
|
|
23
|
+
--claude Install skill for Claude Code agents
|
|
24
|
+
--copilot Install skill for GitHub Copilot agents
|
|
25
|
+
--gemini Install skill for Gemini CLI agents
|
|
22
26
|
|
|
23
27
|
Workspace Creation Options:
|
|
24
28
|
--create-workspace Create a new workspace with agent
|
|
@@ -31,20 +35,18 @@ Workspace Creation Options:
|
|
|
31
35
|
--max-iterations <n> Max agent iterations (default: 3)
|
|
32
36
|
|
|
33
37
|
Examples:
|
|
34
|
-
#
|
|
35
|
-
npx workspace-maxxing
|
|
38
|
+
# Create workspace with agent (recommended)
|
|
39
|
+
npx workspace-maxxing init
|
|
36
40
|
|
|
37
|
-
# Create workspace with
|
|
38
|
-
npx workspace-maxxing
|
|
39
|
-
|
|
40
|
-
# Create workspace in specific folder
|
|
41
|
-
npx workspace-maxxing --create-workspace --workspace-name "My Workflow" --output "./my-workspace"
|
|
41
|
+
# Create workspace with custom name
|
|
42
|
+
npx workspace-maxxing init --workspace-name "Daily Digest"
|
|
42
43
|
|
|
43
44
|
# Create workspace without agent
|
|
44
|
-
npx workspace-maxxing
|
|
45
|
+
npx workspace-maxxing init --no-agent
|
|
45
46
|
|
|
46
|
-
#
|
|
47
|
-
npx workspace-maxxing
|
|
47
|
+
# Install skill to OpenCode
|
|
48
|
+
npx workspace-maxxing install
|
|
49
|
+
npx workspace-maxxing --opencode
|
|
48
50
|
`);
|
|
49
51
|
}
|
|
50
52
|
|
|
@@ -142,13 +144,42 @@ async function main(): Promise<void> {
|
|
|
142
144
|
process.exit(0);
|
|
143
145
|
}
|
|
144
146
|
|
|
145
|
-
// Check for workspace
|
|
146
|
-
if (args.includes('--create-workspace')) {
|
|
147
|
-
|
|
147
|
+
// Check for init command (create workspace with agent)
|
|
148
|
+
if (args.includes('init') || args.includes('--create-workspace')) {
|
|
149
|
+
// Remove 'init' from args if present, keep other flags
|
|
150
|
+
const cleanArgs = args.filter(a => a !== 'init' && a !== '--create-workspace');
|
|
151
|
+
await createWorkspace(cleanArgs);
|
|
148
152
|
return;
|
|
149
153
|
}
|
|
150
154
|
|
|
151
|
-
// Check for install
|
|
155
|
+
// Check for install command
|
|
156
|
+
if (args.includes('install')) {
|
|
157
|
+
const cwd = process.cwd();
|
|
158
|
+
const projectRoot = detectProjectRoot(cwd);
|
|
159
|
+
|
|
160
|
+
if (projectRoot !== cwd) {
|
|
161
|
+
console.log(`Detected project root: ${projectRoot}`);
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
const templatesDir =
|
|
165
|
+
process.env.WORKSPACE_MAXXING_TEMPLATES ??
|
|
166
|
+
path.join(__dirname, '..', 'templates');
|
|
167
|
+
|
|
168
|
+
console.log(`Installing workspace-maxxing skill...`);
|
|
169
|
+
const result = await installSkill(projectRoot, templatesDir, 'opencode');
|
|
170
|
+
|
|
171
|
+
if (result.success) {
|
|
172
|
+
console.log(`Skill installed to: ${result.skillPath}`);
|
|
173
|
+
console.log(`Open a new OpenCode session and invoke the workspace-maxxing skill to get started.`);
|
|
174
|
+
} else {
|
|
175
|
+
console.error(`Installation failed: ${result.error}`);
|
|
176
|
+
process.exit(1);
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
return;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
// Check for install targets (--opencode, --claude, etc.)
|
|
152
183
|
const agentFlags: AgentTarget[] = ['opencode', 'claude', 'copilot', 'gemini'];
|
|
153
184
|
const detectedAgent = agentFlags.find((flag) => args.includes(`--${flag}`));
|
|
154
185
|
|
|
@@ -178,9 +209,8 @@ async function main(): Promise<void> {
|
|
|
178
209
|
return;
|
|
179
210
|
}
|
|
180
211
|
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
process.exit(1);
|
|
212
|
+
// Default: treat as workspace creation (backward compatible)
|
|
213
|
+
await createWorkspace(args);
|
|
184
214
|
}
|
|
185
215
|
|
|
186
216
|
main().catch((error) => {
|
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
# Execution Log
|
|
2
|
-
|
|
3
|
-
## Stage Checklist
|
|
4
|
-
|
|
5
|
-
- [ ] 01-input
|
|
6
|
-
|
|
7
|
-
## Rules
|
|
8
|
-
|
|
9
|
-
1. Mark a stage complete only after its completion criteria are satisfied.
|
|
10
|
-
2. Stages must be checked in ascending numerical order.
|
|
11
|
-
3. Every checked stage must have corresponding evidence notes.
|
|
12
|
-
|
|
13
|
-
## Evidence Notes
|
|
14
|
-
|
|
15
|
-
### 01-input
|
|
16
|
-
- Artifacts:
|
|
17
|
-
- Handoff Summary:
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
# 01-input — Context
|
|
2
|
-
|
|
3
|
-
## Purpose
|
|
4
|
-
This folder executes the 01-input stage of the NoAgent Test workflow.
|
|
5
|
-
|
|
6
|
-
## Inputs
|
|
7
|
-
- Required data artifacts for 01-input
|
|
8
|
-
- Upstream context from previous stage when applicable
|
|
9
|
-
|
|
10
|
-
## Outputs
|
|
11
|
-
- Stage-specific deliverables for downstream consumption
|
|
12
|
-
- Updated markdown artifacts needed by the next stage
|
|
13
|
-
|
|
14
|
-
## Dependencies
|
|
15
|
-
- None (entry stage)
|
|
16
|
-
|
|
17
|
-
## Required Evidence
|
|
18
|
-
- Update `00-meta/execution-log.md` to mark 01-input complete before handoff.
|
|
19
|
-
- Link or reference the markdown artifacts produced in this stage.
|
|
20
|
-
|
|
21
|
-
## Completion Criteria
|
|
22
|
-
- Required outputs are produced and non-empty
|
|
23
|
-
- Outputs conform to stage purpose and markdown-first workflow format
|
|
24
|
-
- Handoff notes are updated for downstream stage
|
|
25
|
-
|
|
26
|
-
## Handoff
|
|
27
|
-
- This is the terminal stage. Package and deliver final output.
|
package/workspace/CONTEXT.md
DELETED
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
# NoAgent Test — Context Router
|
|
2
|
-
|
|
3
|
-
## How to Use This File
|
|
4
|
-
Use this file to route each task to the smallest required context scope.
|
|
5
|
-
|
|
6
|
-
## Task Routing
|
|
7
|
-
This routing table maps task intent to the correct stage context.
|
|
8
|
-
|
|
9
|
-
| When you need to... | Load | Why |
|
|
10
|
-
|---------------------|------|-----|
|
|
11
|
-
| Understand workspace constraints | `SYSTEM.md` | Global rules and stage boundaries |
|
|
12
|
-
| Work in 01-input tasks | `01-input/CONTEXT.md` | Stage contract and required outputs |
|
|
13
|
-
| Check available tools | `00-meta/tools.md` | Tool inventory and approval status |
|
|
14
|
-
|
|
15
|
-
## Loading Order
|
|
16
|
-
1. `SYSTEM.md` (always)
|
|
17
|
-
2. This root `CONTEXT.md`
|
|
18
|
-
3. One relevant stage `CONTEXT.md`
|
|
19
|
-
4. Only the task files needed for that stage
|
|
20
|
-
|
|
21
|
-
## Scope Guardrails
|
|
22
|
-
- Route domain requests into workflow design steps and markdown deliverables.
|
|
23
|
-
- Do not scaffold backend, frontend, or runtime product source files from this router.
|
|
24
|
-
- Keep outputs file-structured and markdown-first across numbered workflow folders.
|
|
25
|
-
|
|
26
|
-
## Sequential Routing Contract
|
|
27
|
-
- Route only to the earliest incomplete stage in `00-meta/execution-log.md`.
|
|
28
|
-
- Refuse jumps to later stages when earlier stages are not marked complete.
|
|
29
|
-
- Append handoff notes for each completed stage before routing onward.
|
|
30
|
-
|
|
31
|
-
## Stage Handoff Routing
|
|
32
|
-
- `01-input` -> deliver final output and close loop
|
|
33
|
-
|
|
34
|
-
## Escalation
|
|
35
|
-
Escalate when required sections are missing, dependencies are contradictory, or no valid stage route can satisfy the task.
|
package/workspace/README.md
DELETED
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
# NoAgent Test Workspace
|
|
2
|
-
|
|
3
|
-
## Structure
|
|
4
|
-
|
|
5
|
-
- `01-input/`
|
|
6
|
-
- `00-meta/`
|
|
7
|
-
|
|
8
|
-
## Usage
|
|
9
|
-
|
|
10
|
-
1. Follow the workflow stages in order
|
|
11
|
-
2. Load CONTEXT.md files selectively — only what you need
|
|
12
|
-
3. Update 00-meta/execution-log.md after each completed stage
|
|
13
|
-
4. Keep outputs in stage folders as markdown workflow artifacts
|
|
14
|
-
5. Run validate.ts to check ICM compliance
|
package/workspace/SYSTEM.md
DELETED
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
# NoAgent Test — System Prompt
|
|
2
|
-
|
|
3
|
-
## Role
|
|
4
|
-
You are an AI assistant operating inside the NoAgent Test workspace. Follow stage boundaries and route tasks through stage-specific CONTEXT files.
|
|
5
|
-
|
|
6
|
-
## Folder Map
|
|
7
|
-
|
|
8
|
-
| Stage | Folder | Purpose |
|
|
9
|
-
|------:|--------|---------|
|
|
10
|
-
| 1 | `01-input/` | Input collection and validation |
|
|
11
|
-
| meta | `00-meta/` | Workspace configuration, tool inventory, and session notes |
|
|
12
|
-
|
|
13
|
-
## Workflow Rules
|
|
14
|
-
1. Read `SYSTEM.md` first, then root `CONTEXT.md`.
|
|
15
|
-
2. Load only one stage `CONTEXT.md` at a time unless handoff explicitly requires another stage.
|
|
16
|
-
3. Keep information canonical; do not duplicate facts across files.
|
|
17
|
-
4. Maintain one-way stage dependencies from earlier stage numbers to later stage numbers.
|
|
18
|
-
|
|
19
|
-
## Scope Guardrails
|
|
20
|
-
- Build and maintain workflow documentation, not product implementation code.
|
|
21
|
-
- Keep stage outputs as markdown artifacts (plans, checklists, prompts, routing notes).
|
|
22
|
-
- If asked to build the product itself, capture that request as workflow requirements and stay in ICM workspace scope.
|
|
23
|
-
|
|
24
|
-
## Sequential Execution Protocol
|
|
25
|
-
1. Complete stages strictly in ascending numeric order.
|
|
26
|
-
2. Record stage completion in `00-meta/execution-log.md` before moving to the next stage.
|
|
27
|
-
3. Do not produce final deliverables until all prior stage checkboxes are complete.
|
|
28
|
-
|
|
29
|
-
## Stage Boundaries
|
|
30
|
-
- Each numbered folder is an execution stage.
|
|
31
|
-
- A stage may consume upstream outputs but must not redefine upstream facts.
|
|
32
|
-
- Cross-stage jumps require explicit routing through root `CONTEXT.md`.
|
|
33
|
-
|
|
34
|
-
## Tooling Policy
|
|
35
|
-
- Check `00-meta/tools.md` before proposing tool installation.
|
|
36
|
-
- Document approved tooling changes in `00-meta/tools.md`.
|
|
Binary file
|