workspace-maxxing 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric Julian Deguzman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # workspace-maxxing
 
-An installable skill package for AI coding agents that scaffolds, validates, and iterates on ICM-style workspaces with explicit workflow routing.
+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.
 
 ## Why This Exists
 
@@ -13,6 +13,8 @@ Most agent workspaces drift over time because prompts are underspecified and con
 - Workflow-aware validation (routing coverage, stage dependency direction, selective loading)
 - Batched autonomous iteration via orchestrator + worker/fixer loops
 - Built-in test-case generation and weighted benchmarking
+- **Create invokable agents** - the skill can build autonomous agents that can be invoked with `@` in your workspace
+- **Self-improving agents** - created agents run through iteration loops to ensure robustness
 
 ## Requirements
 
@@ -46,18 +48,74 @@ npx workspace-maxxing --gemini
 
 ## Quick Start
 
+### Option 1: Install the Skill
+
 1. Install to your preferred target with `npx workspace-maxxing --<target>`.
 2. Open a new agent session.
 3. Invoke the `workspace-maxxing` skill.
 4. Approve the proposed workflow structure.
 5. Let the agent scaffold, validate, and iterate until quality gates pass.
 
+### Option 2: Create a Workspace with Agent
+
+```bash
+# Create workspace with invokable agent (default)
+npx workspace-maxxing --create-workspace --workspace-name "Daily Digest" --stages "01-input,02-process,03-output"
+
+# Create workspace without agent (backward compatible)
+npx workspace-maxxing --create-workspace --workspace-name "My Workflow" --no-agent
+
+# Custom agent name
+npx workspace-maxxing --create-workspace --workspace-name "AI News" --agent-name "@news-agent"
+
+# Custom iteration settings
+npx workspace-maxxing --create-workspace --workspace-name "My Workflow" --threshold 90 --max-iterations 5
+```
+
+### CLI Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--create-workspace` | - | Enable workspace creation mode |
+| `--workspace-name` | "My Workspace" | Name of the workspace |
+| `--stages` | "01-input,02-process,03-output" | Comma-separated stage names |
+| `--output` | "./workspace" | Output directory |
+| `--agent-name` | auto-generated (@workspace-name) | Custom agent name |
+| `--no-agent` | false | Create workspace without agent |
+| `--threshold` | 85 | Robustness threshold for agent iteration |
+| `--max-iterations` | 3 | Max improvement cycles |
+
 ## What Gets Installed
 
 - `SKILL.md` (entry behavior and phase logic)
 - `.workspace-templates/` (SYSTEM/CONTEXT templates and scripts)
 - `scripts/` (scaffold, validate, dispatch, orchestrator, benchmark, etc.)
 
+## Agent Creation Workflow
+
+When you invoke `workspace-maxxing` with a request to create an agent (e.g., "create a daily digest agent"):
+
+1. **Parse the request** - Extract the agent purpose (e.g., "Daily Digest")
+2. **Create ICM workspace** - SYSTEM.md, CONTEXT.md, stage folders
+3. **Create invokable agent** - In `.agents/skills/@<purpose>/`
+4. **Run self-improvement loop**:
+   - Generate test cases (edge, empty, varied inputs)
+   - Validate agent handling
+   - Score robustness (0-100)
+   - If score < 85: improve prompts, retry
+   - Repeat until score >= 85 or max iterations (3)
+5. **Install agent** for platform (OpenCode/Claude/Copilot/Gemini)
+6. **Deliver** workspace with robust agent
+
+### Invoking the Created Agent
+
+After workspace is created, use `@` followed by the agent name:
+
+- **OpenCode**: `@daily-digest`
+- **Claude Code**: Via `.claude/skills/` directory
+- **Copilot**: Via `.github/copilot-instructions/`
+- **Gemini**: Via `.gemini/skills/` directory
+
 ## Workflow Model
 
 The skill follows a phased flow:
@@ -122,14 +180,19 @@ npm test
 
 ## Project Layout
 
-```text
-src/
-	index.ts
-	install.ts
-	scripts/
-templates/
-	SKILL.md
-tests/
+```
+workspace-maxxing/
+├── src/
+│   ├── index.ts           # CLI entry point
+│   ├── install.ts        # Skill installation
+│   ├── agent-creator.ts  # Agent creation
+│   ├── agent-iterator.ts # Agent self-improvement
+│   ├── platforms/        # Platform installers
+│   └── scripts/          # Core scripts
+├── templates/
+│   ├── SKILL.md         # Main skill definition
+│   └── .workspace-templates/  # Workspace templates
+└── tests/
 ```
 
 ## Contributing
@@ -141,4 +204,4 @@ tests/
 
 ## License
 
-MIT
+MIT License - see [LICENSE](LICENSE) file for details.

package/dist/install.d.ts

@@ -12,7 +12,7 @@ export declare function getAgentTargetPath(projectRoot: string, agent: AgentTarg
 export declare function detectProjectRoot(startDir: string): string;
 /**
  * Install the workspace-maxxing skill into a project.
- * Copies SKILL.md, .workspace-templates/, and scripts/ to the agent-specific skill directory.
+ * Copies SKILL.md, .workspace-templates/, scripts/, and skills/ to the agent-specific skill directory.
  */
 export declare function installSkill(projectRoot: string, templatesDir: string, agent?: AgentTarget): Promise<InstallResult>;
 //# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAGlF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB1D;AA0BD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,WAAuB,GAC7B,OAAO,CAAC,aAAa,CAAC,CA2BxB"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAGlF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB1D;AA0BD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,WAAuB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAkCxB"}

package/dist/install.js

@@ -87,7 +87,7 @@ function copyDirSync(src, dest) {
 }
 /**
  * Install the workspace-maxxing skill into a project.
- * Copies SKILL.md, .workspace-templates/, and scripts/ to the agent-specific skill directory.
+ * Copies SKILL.md, .workspace-templates/, scripts/, and skills/ to the agent-specific skill directory.
  */
 async function installSkill(projectRoot, templatesDir, agent = undefined) {
     const skillDir = getAgentTargetPath(projectRoot, agent);
@@ -107,6 +107,12 @@ async function installSkill(projectRoot, templatesDir, agent = undefined) {
             const scriptsDest = path.join(skillDir, 'scripts');
             copyDirSync(scriptsSrc, scriptsDest);
         }
+        // Copy skills/ sub-directory for sub-skill invocation
+        const skillsSrc = path.join(templatesDir, '.workspace-templates', 'skills');
+        if (fs.existsSync(skillsSrc)) {
+            const skillsDest = path.join(skillDir, 'skills');
+            copyDirSync(skillsSrc, skillsDest);
+        }
         return { success: true, skillPath: skillDir };
     }
     catch (error) {

package/dist/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workspace-maxxing",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "npx-installable skill for AI agents to create structured workspaces using ICM methodology",
   "bin": {
     "workspace-maxxing": "dist/index.js"

package/src/install.ts

@@ -69,7 +69,7 @@ function copyDirSync(src: string, dest: string): void {
 
 /**
  * Install the workspace-maxxing skill into a project.
- * Copies SKILL.md, .workspace-templates/, and scripts/ to the agent-specific skill directory.
+ * Copies SKILL.md, .workspace-templates/, scripts/, and skills/ to the agent-specific skill directory.
  */
 export async function installSkill(
   projectRoot: string,
@@ -97,6 +97,13 @@ export async function installSkill(
       copyDirSync(scriptsSrc, scriptsDest);
     }
 
+    // Copy skills/ sub-directory for sub-skill invocation
+    const skillsSrc = path.join(templatesDir, '.workspace-templates', 'skills');
+    if (fs.existsSync(skillsSrc)) {
+      const skillsDest = path.join(skillDir, 'skills');
+      copyDirSync(skillsSrc, skillsDest);
+    }
+
     return { success: true, skillPath: skillDir };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);

package/templates/SKILL.md

@@ -18,6 +18,72 @@ Autonomous workflow system that creates, validates, and improves ICM-compliant w
 - User asks to run test cases against a workspace
 - **User asks to create an agent for a specific task** (e.g., "create a daily digest agent", "make a news aggregator agent")
 
+## Tool Discovery & Agent Harness
+
+This skill is designed to **fully utilize its agent harness**. When running:
+
+### 1. Tool Discovery
+
+At the start of execution (especially during RESEARCH or ARCHITECTURE phases):
+- Scan available tools in the workspace (check `00-meta/tools.md` or `tools/` directory)
+- Look for MCP tools that could assist with the workflow
+- Use the **tooling** sub-skill to assess and install needed tools: `/skill tooling --workspace ./workspace`
+- Tools should be leveraged to enhance research, validation, and iteration
+
+### 2. Sub-Skill Invocation
+
+All sub-skills are invokable via **slash command** in your AI agent session:
+
+| Command | Sub-Skill | Purpose |
+|---------|-----------|---------|
+| `/skill research` | `research` | Conduct research phase |
+| `/skill architecture` | `architecture` | Design workspace architecture |
+| `/skill validation` | `validation` | Validate workspace ICM compliance |
+| `/skill iteration` | `iteration` | Run improvement iteration |
+| `/skill testing` | `testing` | Generate and run tests |
+| `/skill tooling` | `tooling` | Assess and install tools |
+| `/skill prompt-engineering` | `prompt-engineering` | Improve prompt quality |
+| `/skill worker` | `worker` | Execute worker task |
+| `/skill fixer` | `fixer` | Fix failing test cases |
+
+**To invoke a sub-skill**, use the dispatch script:
+```bash
+node skills/dispatch.ts --skill <sub-skill-name> --workspace ./workspace
+```
+
+Or if your agent supports slash commands:
+```
+/skill research --workspace ./workspace
+```
+
+### 3. Full Agent Harness Usage
+
+This skill provides a complete agent development harness:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ workspace-maxxing                                              │
+├─────────────────────────────────────────────────────────────────┤
+│  TOOLS: Look for available tools, install via tooling skill    │
+│    ↓                                                            │
+│  RESEARCH: Use /skill research to gather requirements         │
+│    ↓                                                            │
+│  ARCHITECTURE: Use /skill architecture to design structure    │
+│    ↓                                                            │
+│  BUILD: Use scaffold.ts to create workspace                   │
+│    ↓                                                            │
+│  VALIDATE: Use /skill validation to check ICM compliance     │
+│    ↓                                                            │
+│  ITERATE: Use /skill iteration for autonomous improvement     │
+│    ↓                                                            │
+│  TOOLING: Use /skill tooling to add more tools                 │
+│    ↓                                                            │
+│  DELIVER: Complete workspace with validated agents            │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+**Never skip sub-skills** - each one contributes to a robust workspace.
+
 ## Agent Creation Workflow
 
 When you invoke `workspace-maxxing` with a request to create an agent (e.g., "create a daily digest agent"), follow this flow:
@@ -42,6 +108,7 @@ User: "Create a daily digest agent"
 
 ```
 -> Extract purpose: "Daily Digest"
+-> DISCOVER TOOLS: Use /skill tooling to find relevant tools (e.g., RSS, web scraping, summarization)
 -> Create workspace with stages: 01-input, 02-process, 03-output
 -> Create agent: @daily-digest in .agents/skills/daily-digest/
 -> Run iteration:
@@ -52,6 +119,8 @@ User: "Create a daily digest agent"
 -> Agent is ready to invoke with @daily-digest
 ```
 
+**Key**: Always look for and leverage tools when creating agents or workspaces.
+
 ## When Not to Use
 
 - Simple file creation or editing (use direct file operations)
@@ -143,6 +212,25 @@ node scripts/orchestrator.ts --workspace ./workspace --batch-size 3 --score-thre
 
 ## Sub-Skill Dispatch
 
+**All sub-skills are invokable via slash command in your AI agent session:**
+
+| Command | Sub-Skill | Purpose |
+|---------|-----------|---------|
+| `/skill research` | `research` | Conduct research phase |
+| `/skill architecture` | `architecture` | Design workspace architecture |
+| `/skill validation` | `validation` | Validate workspace ICM compliance |
+| `/skill iteration` | `iteration` | Run improvement iteration |
+| `/skill testing` | `testing` | Generate and run tests |
+| `/skill tooling` | `tooling` | Assess and install tools |
+| `/skill prompt-engineering` | `prompt-engineering` | Improve prompt quality |
+| `/skill worker` | `worker` | Execute worker task |
+| `/skill fixer` | `fixer` | Fix failing test cases |
+
+**To invoke a sub-skill**, use the dispatch script:
+```bash
+node skills/dispatch.ts --skill <sub-skill-name> --workspace ./workspace
+```
+
 | Condition | Sub-Skill | Command |
 |-----------|-----------|---------|
 | Starting new workflow | `research` | `node scripts/dispatch.ts --skill research --workspace ./workspace` |