workspace-maxxing 0.2.0 → 0.4.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 +42 -63
- 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/templates/SKILL.md +22 -2
- 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
|
@@ -1,83 +1,62 @@
|
|
|
1
1
|
# workspace-maxxing
|
|
2
2
|
|
|
3
|
-
An
|
|
3
|
+
An AI agent skill that builds ICM-compliant workspaces with invokable agents. The skill runs **inside your AI agent** and creates workspaces + agents on demand.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## The Flow
|
|
6
6
|
|
|
7
|
-
Most agent workspaces drift over time because prompts are underspecified and context loading is inconsistent. `workspace-maxxing` provides a repeatable workflow that generates structured `SYSTEM.md` and `CONTEXT.md` contracts, validates them, and improves them through autonomous iteration.
|
|
8
|
-
|
|
9
|
-
## Features
|
|
10
|
-
|
|
11
|
-
- Multi-agent install targets: OpenCode, Claude Code, GitHub Copilot, Gemini CLI
|
|
12
|
-
- ICM workspace scaffolding with robust root and per-stage context contracts
|
|
13
|
-
- Workflow-aware validation (routing coverage, stage dependency direction, selective loading)
|
|
14
|
-
- Batched autonomous iteration via orchestrator + worker/fixer loops
|
|
15
|
-
- Built-in test-case generation and weighted benchmarking
|
|
16
|
-
- **Create invokable agents** - the skill can build autonomous agents that can be invoked with `@` in your workspace
|
|
17
|
-
- **Self-improving agents** - created agents run through iteration loops to ensure robustness
|
|
18
|
-
|
|
19
|
-
## Requirements
|
|
20
|
-
|
|
21
|
-
- Node.js 18+
|
|
22
|
-
- `npx` available in your shell
|
|
23
|
-
|
|
24
|
-
## Install
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
# OpenCode (default target)
|
|
28
|
-
npx workspace-maxxing --opencode
|
|
29
|
-
|
|
30
|
-
# Claude Code
|
|
31
|
-
npx workspace-maxxing --claude
|
|
32
|
-
|
|
33
|
-
# GitHub Copilot
|
|
34
|
-
npx workspace-maxxing --copilot
|
|
35
|
-
|
|
36
|
-
# Gemini CLI
|
|
37
|
-
npx workspace-maxxing --gemini
|
|
38
7
|
```
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
| OpenCode | `--opencode` | `.agents/skills/workspace-maxxing/` |
|
|
45
|
-
| Claude Code | `--claude` | `.claude/skills/` |
|
|
46
|
-
| GitHub Copilot | `--copilot` | `.github/copilot-instructions/` |
|
|
47
|
-
| Gemini CLI | `--gemini` | `.gemini/skills/` |
|
|
8
|
+
1. Install: npx workspace-maxxing install
|
|
9
|
+
2. Invoke in AI: @workspace-maxxing
|
|
10
|
+
3. Ask: "Create a daily digest workspace"
|
|
11
|
+
4. Skill builds: workspace + @daily-digest agent
|
|
12
|
+
```
|
|
48
13
|
|
|
49
14
|
## Quick Start
|
|
50
15
|
|
|
51
|
-
|
|
16
|
+
```bash
|
|
17
|
+
# Step 1: Install the skill to your project
|
|
18
|
+
npx workspace-maxxing install
|
|
52
19
|
|
|
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.
|
|
20
|
+
# Step 2: In your AI agent, invoke the skill
|
|
21
|
+
@workspace-maxxing
|
|
58
22
|
|
|
59
|
-
|
|
23
|
+
# Step 3: Ask it to create something
|
|
24
|
+
"Create a workspace for my daily news aggregator"
|
|
25
|
+
```
|
|
60
26
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
27
|
+
The skill will then:
|
|
28
|
+
- Research your request
|
|
29
|
+
- Design the workspace architecture
|
|
30
|
+
- Build the ICM folder structure
|
|
31
|
+
- Create an invokable agent inside
|
|
32
|
+
- Run self-improvement on the agent
|
|
33
|
+
- Deliver the complete workspace
|
|
64
34
|
|
|
65
|
-
|
|
66
|
-
npx workspace-maxxing --create-workspace --workspace-name "My Workflow" --no-agent
|
|
35
|
+
## What Gets Created
|
|
67
36
|
|
|
68
|
-
|
|
69
|
-
npx workspace-maxxing --create-workspace --workspace-name "AI News" --agent-name "@news-agent"
|
|
37
|
+
When you ask `@workspace-maxxing` to create a workspace for "Daily Digest":
|
|
70
38
|
|
|
71
|
-
# Custom iteration settings
|
|
72
|
-
npx workspace-maxxing --create-workspace --workspace-name "My Workflow" --threshold 90 --max-iterations 5
|
|
73
39
|
```
|
|
40
|
+
my-workspace/
|
|
41
|
+
├── .agents/skills/daily-digest/ ← Invokable with @daily-digest
|
|
42
|
+
│ ├── SKILL.md
|
|
43
|
+
│ └── prompts/
|
|
44
|
+
├── 01-input/
|
|
45
|
+
├── 02-process/
|
|
46
|
+
├── 03-output/
|
|
47
|
+
├── SYSTEM.md
|
|
48
|
+
└── CONTEXT.md
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Now you can use `@daily-digest` to run that workflow!
|
|
74
52
|
|
|
75
|
-
|
|
53
|
+
## Commands
|
|
76
54
|
|
|
77
|
-
|
|
|
78
|
-
|
|
79
|
-
|
|
|
80
|
-
|
|
|
55
|
+
| Command | What It Does |
|
|
56
|
+
|---------|-------------|
|
|
57
|
+
| `npx workspace-maxxing install` | Install skill to current project |
|
|
58
|
+
| `@workspace-maxxing` | Invoke in your AI agent |
|
|
59
|
+
| `npx workspace-maxxing --opencode` | Install for specific platform |
|
|
81
60
|
| `--stages` | "01-input,02-process,03-output" | Comma-separated stage names |
|
|
82
61
|
| `--output` | "./workspace" | Output directory |
|
|
83
62
|
| `--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) => {
|
package/templates/SKILL.md
CHANGED
|
@@ -1,13 +1,19 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: workspace-maxxing
|
|
3
|
-
description: "Autonomously creates, validates, and improves ICM-compliant workspaces using batched parallel sub-agents. Use when user asks to 'build a workspace', 'create a workflow', 'automate a process', 'improve this workspace', 'validate this workspace', 'iterate on this workspace',
|
|
3
|
+
description: "Autonomously creates, validates, and improves ICM-compliant workspaces using batched parallel sub-agents. Use when user asks to 'build a workspace', 'create a workflow', 'automate a process', 'improve this workspace', 'validate this workspace', 'iterate on this workspace', 'run test cases', or 'create an agent'."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Workspace-Maxxing Skill
|
|
7
7
|
|
|
8
8
|
## Overview
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
This is an **AI agent skill** that creates ICM-compliant workspaces with invokable agents.
|
|
11
|
+
|
|
12
|
+
**User Flow:**
|
|
13
|
+
1. Install: `npx workspace-maxxing install`
|
|
14
|
+
2. Invoke: `@workspace-maxxing` in your AI agent
|
|
15
|
+
3. Request: "Create a daily digest workspace" (or similar)
|
|
16
|
+
4. The skill builds: ICM workspace + invokable agent
|
|
11
17
|
|
|
12
18
|
## When to Use
|
|
13
19
|
|
|
@@ -18,6 +24,20 @@ Autonomous workflow system that creates, validates, and improves ICM-compliant w
|
|
|
18
24
|
- User asks to run test cases against a workspace
|
|
19
25
|
- **User asks to create an agent for a specific task** (e.g., "create a daily digest agent", "make a news aggregator agent")
|
|
20
26
|
|
|
27
|
+
## User Commands (to the AI agent)
|
|
28
|
+
|
|
29
|
+
When you invoke `@workspace-maxxing`, you can ask:
|
|
30
|
+
|
|
31
|
+
| Request | What Happens |
|
|
32
|
+
|---------|-------------|
|
|
33
|
+
| "Build a workspace for X" | Creates ICM workspace with X workflow |
|
|
34
|
+
| "Create an agent for Y" | Creates invokable @agent for Y task |
|
|
35
|
+
| "Validate my workspace" | Checks ICM compliance |
|
|
36
|
+
| "Improve my workspace" | Runs autonomous iteration |
|
|
37
|
+
| "Add tools for Z" | Uses tooling sub-skill to install tools |
|
|
38
|
+
|
|
39
|
+
The skill will then execute the appropriate phases internally.
|
|
40
|
+
|
|
21
41
|
## Tool Discovery & Agent Harness
|
|
22
42
|
|
|
23
43
|
This skill is designed to **fully utilize its agent harness**. When running:
|
|
@@ -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
|