workspace-maxxing 0.3.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.
Files changed (3) hide show
  1. package/README.md +39 -70
  2. package/package.json +1 -1
  3. package/templates/SKILL.md +22 -2
package/README.md CHANGED
@@ -1,93 +1,62 @@
1
1
  # workspace-maxxing
2
2
 
3
- An installable skill package for AI coding agents that scaffolds, validates, and iterates on ICM-style workspaces with explicit workflow routing. Now with **invokable agent creation** - the skill can create autonomous agents that can be invoked with `@` in your workspace.
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
- ## Why This Exists
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
7
+ ```
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
+ ```
18
13
 
19
14
  ## Quick Start
20
15
 
21
- ### One Command Does Everything
22
-
23
16
  ```bash
24
- # Create workspace with agent (recommended)
25
- npx workspace-maxxing init
26
-
27
- # Install skill to OpenCode
17
+ # Step 1: Install the skill to your project
28
18
  npx workspace-maxxing install
29
19
 
30
- # Or use the old way (still works)
31
- npx workspace-maxxing --opencode
32
- ```
33
-
34
- That's it! No extra flags needed.
35
-
36
- ## Two Main Use Cases
37
-
38
- ### Use Case 1: Create a New Workspace with Agent
20
+ # Step 2: In your AI agent, invoke the skill
21
+ @workspace-maxxing
39
22
 
40
- When you want to start a new workflow project:
41
-
42
- ```bash
43
- # Basic (creates "My Workspace" with 3 stages)
44
- npx workspace-maxxing init
45
-
46
- # Custom name
47
- npx workspace-maxxing init --workspace-name "Daily Digest"
48
-
49
- # Custom stages
50
- npx workspace-maxxing init --stages "01-input,02-process,03-output,04-deploy"
51
-
52
- # Without agent (backward compatible)
53
- npx workspace-maxxing init --no-agent
54
-
55
- # To specific folder
56
- npx workspace-maxxing init --output "./my-workspace"
23
+ # Step 3: Ask it to create something
24
+ "Create a workspace for my daily news aggregator"
57
25
  ```
58
26
 
59
- This creates:
60
- - ICM workspace folder structure
61
- - Invokable `@agent` in `.agents/skills/`
62
- - Runs self-improvement loop (score >= 85)
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
63
34
 
64
- ### Use Case 2: Install the Skill to Your Project
35
+ ## What Gets Created
65
36
 
66
- When you want to use workspace-maxxing as a skill in your AI agent:
37
+ When you ask `@workspace-maxxing` to create a workspace for "Daily Digest":
67
38
 
68
- ```bash
69
- # Install to current project (OpenCode)
70
- npx workspace-maxxing install
71
-
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
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
77
49
  ```
78
50
 
79
- This installs the skill to `.agents/skills/workspace-maxxing/` so you can invoke it in your AI agent session with `@workspace-maxxing`.
51
+ Now you can use `@daily-digest` to run that workflow!
80
52
 
81
- ## CLI Options
53
+ ## Commands
82
54
 
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 |
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 |
91
60
  | `--stages` | "01-input,02-process,03-output" | Comma-separated stage names |
92
61
  | `--output` | "./workspace" | Output directory |
93
62
  | `--agent-name` | auto-generated (@workspace-name) | Custom agent name |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "workspace-maxxing",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "npx-installable skill for AI agents to create structured workspaces using ICM methodology",
5
5
  "bin": {
6
6
  "workspace-maxxing": "dist/index.js"
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', or 'run test cases'."
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
- Autonomous workflow system that creates, validates, and improves ICM-compliant workspaces through phased execution, batched parallel sub-agent iteration, and condition-driven improvement loops.
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: