knowzcode 0.1.0 → 0.3.1

package/commands/fix.md

@@ -95,13 +95,13 @@ REPEAT until all checks pass:
 
 ## Execution
 
-Delegate to the **microfix-specialist** agent via `Task()`. Pass the target file/NodeID and fix summary.
-
-The agent validates scope, implements the minimal fix, runs the verification loop, logs the outcome, and commits.
+Delegate to the **microfix-specialist** agent via `Task()` with these parameters:
+- `subagent_type`: `"microfix-specialist"`
+- `prompt`: Task-specific context only (role definition is auto-loaded from `agents/microfix-specialist.md`):
+  > **Target**: {target file or NodeID}
+  > **Fix summary**: {summary}
+  > Validate scope, implement the minimal fix, run the verification loop, log the outcome, and commit.
+- `description`: `"Micro-fix: {summary}"`
+- `mode`: `"bypassPermissions"`
 
 > **Note:** Micro-fixes use subagent delegation only. Agent Teams overhead is not justified for single-file, <50 line fixes.
-
-## Context Files
-
-- knowzcode/automation_manifest.md
-- knowzcode/prompts/Execute_Micro_Fix.md

package/commands/init.md

@@ -8,7 +8,7 @@ You are the **KnowzCode Initialization Agent**. Set up the KnowzCode framework i
 
 ## What KnowzCode Provides
 
-KnowzCode is an AI-powered development methodology that provides:
+KnowzCode is a structured development methodology that provides:
 - **Structured TDD workflow** with quality gates
 - **Specification-driven development** with living documentation
 - **Comprehensive tracking** of WorkGroups and specifications
@@ -33,6 +33,7 @@ knowzcode/
 ├── knowzcode_log.md
 ├── knowzcode_architecture.md
 ├── knowzcode_loop.md
+├── knowzcode_orchestration.md
 ├── platform_adapters.md
 ├── environment_context.md
 ├── user_preferences.md (if configured)
@@ -59,6 +60,20 @@ Use the embedded templates below.
 - If yes: prompt for testing frameworks, code style, quality priorities
 - Create `knowzcode/user_preferences.md`
 
+### 5.5. Configure orchestration defaults (optional)
+
+Ask: "Would you like to configure agent orchestration defaults? (optional — can be changed later in knowzcode/knowzcode_orchestration.md)"
+
+If yes: prompt for:
+- Max concurrent builders (1-5, default: 5)
+- Scout mode (full/minimal/none, default: full)
+- Default specialists (checkboxes: security-officer, test-advisor, project-advisor)
+- MCP agents enabled (yes/no, default: yes)
+
+If no: generate with all defaults.
+
+Generate `knowzcode/knowzcode_orchestration.md` from the template (always — it's part of the standard file set).
+
 ### 6. Create .gitignore
 
 Protect environment-specific files from git:
@@ -80,7 +95,7 @@ CHECK for existing files:
   - AGENTS.md or AGENTS.override.md → offer to generate Codex adapter
   - GEMINI.md or ~/.gemini/GEMINI.md → offer to generate Gemini adapter
   - .cursor/rules/ or .cursorrules (deprecated) → offer Cursor adapter (.cursor/rules/knowzcode.mdc)
-  - .github/copilot-instructions.md → offer Copilot adapter
+  - .github/copilot-instructions.md OR .github/ directory → offer Copilot adapter (full prompt files)
   - .windsurf/rules/ or .windsurfrules (deprecated) → offer Windsurf adapter (.windsurf/rules/knowzcode.md)
 ```
 
@@ -119,6 +134,53 @@ After generation, verify each adapter:
 
 Adapter templates are in `knowzcode/platform_adapters.md`. Copy the relevant sections into the appropriate files.
 
+**Step 7e: Copilot-specific generation**
+
+When Copilot is selected, generate the full prompt file suite in addition to the instructions file:
+
+```
+1. Create .github/ directory if it doesn't exist
+2. Create .github/copilot-instructions.md from platform_adapters.md template Section A
+3. Create .github/prompts/ directory
+4. Generate all 9 prompt files from platform_adapters.md template Section B:
+   - .github/prompts/kc-work.prompt.md
+   - .github/prompts/kc-analyze.prompt.md
+   - .github/prompts/kc-specify.prompt.md
+   - .github/prompts/kc-implement.prompt.md
+   - .github/prompts/kc-audit.prompt.md
+   - .github/prompts/kc-finalize.prompt.md
+   - .github/prompts/kc-fix.prompt.md
+   - .github/prompts/kc-plan.prompt.md
+   - .github/prompts/kc-continue.prompt.md
+5. Replace "vX.Y.Z" in generated files with the current KnowzCode version
+6. Optionally create .vscode/mcp.json skeleton from template Section C
+   (ask user: "Would you like to generate MCP configuration for VS Code?")
+```
+
+**Skip Agent Teams enablement for Copilot** — Copilot uses single-agent sequential execution.
+
+**Copilot success message:**
+```
+GitHub Copilot adapter generated:
+  .github/copilot-instructions.md     (repository-level instructions)
+  .github/prompts/kc-work.prompt.md   (start workflow: #prompt:kc-work)
+  .github/prompts/kc-analyze.prompt.md
+  .github/prompts/kc-specify.prompt.md
+  .github/prompts/kc-implement.prompt.md
+  .github/prompts/kc-audit.prompt.md
+  .github/prompts/kc-finalize.prompt.md
+  .github/prompts/kc-fix.prompt.md    (quick fix: #prompt:kc-fix)
+  .github/prompts/kc-plan.prompt.md   (research: #prompt:kc-plan)
+  .github/prompts/kc-continue.prompt.md (resume: #prompt:kc-continue)
+
+Usage in VS Code:
+  #prompt:kc-work "Build user authentication"  — Start a feature
+  #prompt:kc-fix "Fix login redirect bug"      — Quick fix
+  #prompt:kc-continue                          — Resume where you left off
+
+See knowzcode/copilot_execution.md for the full execution guide.
+```
+
 ### 7.5. Enable Agent Teams (Claude Code only)
 
 If the user is on Claude Code, **actively offer** to enable Agent Teams:
@@ -133,13 +195,17 @@ giving you richer multi-agent coordination.
 Without it, KnowzCode uses subagent delegation (works fine, just less interactive)."
 
 Options:
-  - Yes (recommended)
+  - Yes, for this project only (recommended)
+  - Yes, for all projects (writes to ~/.claude/settings.json)
   - No (use subagent fallback)
 ```
 
-**Step 7.5b: If yes, create/update `.claude/settings.local.json`**
+**Step 7.5b: If yes, create/update the appropriate settings file**
 
-Read `.claude/settings.local.json` if it exists. Merge the Agent Teams env var into it:
+- **"This project only"** → write to `.claude/settings.local.json` (project-level, gitignored)
+- **"All projects"** → write to `~/.claude/settings.json` (home-level global config)
+
+Read the target settings file if it exists. Merge the Agent Teams env var into it:
 
 ```json
 {
@@ -162,7 +228,7 @@ This works correctly — no action needed.
 
 **Step 7.5d: If no, proceed normally** — subagent delegation works without any configuration.
 
-### 8. Optional: Set up enterprise compliance
+### 8. Optional: Set up enterprise compliance (experimental)
 
 - Ask: "Would you like to set up enterprise compliance features? (optional)"
 - If yes: create `knowzcode/enterprise/` directory with manifest and templates
@@ -188,6 +254,7 @@ Created:
   knowzcode/knowzcode_log.md
   knowzcode/knowzcode_architecture.md
   knowzcode/knowzcode_loop.md
+  knowzcode/knowzcode_orchestration.md
   knowzcode/platform_adapters.md
   knowzcode/.gitignore
   knowzcode/specs/
@@ -307,6 +374,58 @@ Next steps:
 **Test Runner:** [Auto-detected]
 ```
 
+### knowzcode_orchestration.md
+```markdown
+# KnowzCode Orchestration Configuration
+
+**Purpose:** Project-level defaults for team sizing and agent orchestration. Read by `/kc:work` and `/kc:audit` at startup. Per-invocation flags override these settings.
+
+---
+
+## Builder Configuration
+
+```yaml
+max_builders: 5
+```
+
+---
+
+## Scout Configuration
+
+```yaml
+scout_mode: full
+```
+
+---
+
+## Specialist Defaults
+
+```yaml
+default_specialists: []
+```
+
+---
+
+## MCP Agent Configuration
+
+```yaml
+mcp_agents_enabled: true
+```
+
+---
+
+## Override Precedence
+
+| Setting | Config Default | Flag Override |
+|---------|---------------|--------------|
+| max_builders | `max_builders:` | `--max-builders=N` |
+| scout_mode | `scout_mode:` | `--no-scouts` |
+| default_specialists | `default_specialists:` | `--specialists`, `--no-specialists` |
+| mcp_agents_enabled | `mcp_agents_enabled:` | `--no-mcp` |
+
+Per-invocation flags always win. `--specialists` adds to defaults; `--no-specialists` clears all.
+```
+
 ---
 
 ## Error Handling