specweave 0.4.1 → 0.6.3

package/{src → plugins/specweave}/commands/specweave.md

@@ -39,6 +39,16 @@ This master command routes to SpecWeave increment lifecycle subcommands.
 | **sync-github** | Sync increment to GitHub issues | `/specweave sync-github 0001` |
 | **sync-jira** | Sync increment to Jira epics/stories | `/specweave sync-jira import SCRUM-123` |
 
+### GitHub Plugin
+
+| Subcommand | Description | Example |
+|------------|-------------|---------|
+| **github.create-issue** | Create GitHub issue from increment | `/specweave github.create-issue 0001` |
+| **github.sync** | Bidirectional sync with GitHub | `/specweave github.sync 0001` |
+| **github.sync-tasks** | Sync tasks as GitHub sub-issues | `/specweave github.sync-tasks 0001` |
+| **github.close-issue** | Close GitHub issue | `/specweave github.close-issue 0001` |
+| **github.status** | Show GitHub sync status | `/specweave github.status` |
+
 ---
 
 ## Subcommand Routing
@@ -53,14 +63,21 @@ This master command routes to SpecWeave increment lifecycle subcommands.
 
 ```yaml
 subcommands:
-  inc: .claude/commands/specweave.inc.md
-  build: .claude/commands/specweave.do.md
-  next: .claude/commands/specweave.next.md
-  done: .claude/commands/specweave.done.md
-  progress: .claude/commands/specweave.progress.md
-  validate: .claude/commands/specweave.validate.md
-  sync-github: .claude/commands/specweave.sync-github.md
-  sync-jira: .claude/commands/specweave.sync-jira.md
+  inc: .claude/commands/specweave:inc.md
+  build: .claude/commands/specweave:do.md
+  next: .claude/commands/specweave:next.md
+  done: .claude/commands/specweave:done.md
+  progress: .claude/commands/specweave:progress.md
+  validate: .claude/commands/specweave:validate.md
+  sync-github: .claude/commands/specweave:sync-github.md
+  sync-jira: .claude/commands/specweave:sync-jira.md
+
+  # GitHub Plugin Commands
+  github.create-issue: .claude/commands/specweave-github:github-create-issue.md
+  github.sync: .claude/commands/specweave-github:github-sync.md
+  github.sync-tasks: .claude/commands/specweave-github:github-sync-tasks.md
+  github.close-issue: .claude/commands/specweave-github:github-close-issue.md
+  github.status: .claude/commands/specweave-github:github-status.md
 ```
 
 ---
@@ -90,7 +107,7 @@ Else:
 ### Step 3: Route to Command
 
 ```
-Read file: .claude/commands/specweave.inc.md
+Read file: .claude/commands/specweave:inc.md
 Execute: Command content with arguments
 ```
 
@@ -108,8 +125,8 @@ Execute: Command content with arguments
 **Routing**:
 ```
 Parse: subcommand = "inc", args = ["User authentication"]
-Route to: .claude/commands/specweave.inc.md
-Execute: /specweave.inc "User authentication"
+Route to: .claude/commands/specweave:inc.md
+Execute: /specweave:inc "User authentication"
 ```
 
 ### Example 2: Build Current Increment
@@ -122,8 +139,8 @@ Execute: /specweave.inc "User authentication"
 **Routing**:
 ```
 Parse: subcommand = "build", args = []
-Route to: .claude/commands/specweave.do.md
-Execute: /specweave.do (auto-finds active increment)
+Route to: .claude/commands/specweave:do.md
+Execute: /specweave:do (auto-finds active increment)
 ```
 
 ### Example 3: Smart Transition
@@ -136,8 +153,8 @@ Execute: /specweave.do (auto-finds active increment)
 **Routing**:
 ```
 Parse: subcommand = "next", args = []
-Route to: .claude/commands/specweave.next.md
-Execute: /specweave.next (validates, closes, suggests)
+Route to: .claude/commands/specweave:next.md
+Execute: /specweave:next (validates, closes, suggests)
 ```
 
 ### Example 4: Invalid Subcommand
@@ -165,8 +182,16 @@ Available subcommands:
     sync-github     - Sync to GitHub
     sync-docs       - Sync documentation (review/update)
 
+  GitHub Plugin:
+    github.create-issue  - Create GitHub issue from increment
+    github.sync          - Bidirectional sync with GitHub
+    github.sync-tasks    - Sync tasks as GitHub sub-issues
+    github.close-issue   - Close GitHub issue
+    github.status        - Show GitHub sync status
+
 Usage: /specweave <subcommand> [arguments]
 Example: /specweave inc "User authentication"
+Example: /specweave github.create-issue 0001
 ```
 
 ---
@@ -184,14 +209,14 @@ function handleSpecweaveCommand(rawInput) {
 
   // Routing table
   const routes = {
-    'inc': 'specweave.inc.md',
-    'do': 'specweave.do.md',
-    'next': 'specweave.next.md',
-    'done': 'specweave.done.md',
-    'progress': 'specweave.progress.md',
-    'validate': 'specweave.validate.md',
-    'sync-github': 'specweave.sync-github.md',
-    'sync-docs': 'specweave.sync-docs.md'
+    'inc': 'inc.md',
+    'do': 'do.md',
+    'next': 'next.md',
+    'done': 'done.md',
+    'progress': 'progress.md',
+    'validate': 'validate.md',
+    'sync-github': 'sync-github.md',
+    'sync-docs': 'sync-docs.md'
   };
 
   // Validate subcommand
@@ -228,7 +253,7 @@ User's project:
   .claude/commands/do.md    (their own build command)
 
 SpecWeave installation:
-  .claude/commands/specweave.do.md    (SpecWeave's build)
+  .claude/commands/specweave:do.md    (SpecWeave's build)
   .claude/commands/specweave.md          (master router)
 
 Result: ✅ NO COLLISION - Both coexist!
@@ -353,7 +378,7 @@ If you have code/docs referencing old commands:
 /progress         → /specweave progress
 /validate         → /specweave validate
 /sync-github      → /specweave sync-github
-/sync-docs        → /specweave sync-docs
+/specweave:sync-docs        → /specweave sync-docs
 ```
 
 ### Automated Migration Script
@@ -407,6 +432,13 @@ Project Setup:
   sync-github <id>   - Sync increment to GitHub issues
   sync-docs [mode] [id] - Sync documentation (review/update)
 
+GitHub Plugin:
+  github.create-issue <id>  - Create GitHub issue from increment
+  github.sync <id>          - Bidirectional sync with GitHub
+  github.sync-tasks <id>    - Sync tasks as GitHub sub-issues
+  github.close-issue <id>   - Close GitHub issue
+  github.status             - Show GitHub sync status
+
 Examples:
   /specweave inc "User authentication"
   /specweave do

package/{src/commands/specweave.sync-docs.md → plugins/specweave/commands/sync-docs.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave.sync-docs
+name: sync-docs
 description: Bidirectional documentation sync - review strategic docs before implementation OR update living docs from completed increments with conflict resolution
 ---
 
@@ -581,7 +581,7 @@ Documentation is now in sync with increment {increment_id}! 🎉
 Available increments:
   {list .specweave/increments/*/}
 
-Usage: /sync-docs [review|update] [increment_id]
+Usage: /specweave:sync-docs [review|update] [increment_id]
 ```
 
 ### Error: No Increment Files
@@ -605,7 +605,7 @@ Valid modes:
   - update (post-implementation doc sync)
   - [none] (auto-detect based on status)
 
-Usage: /sync-docs [review|update] [increment_id]
+Usage: /specweave:sync-docs [review|update] [increment_id]
 ```
 
 ---
@@ -614,7 +614,7 @@ Usage: /sync-docs [review|update] [increment_id]
 
 ### Example 1: Auto-detect mode for current increment
 ```
-User: /sync-docs
+User: /specweave:sync-docs
 
 Output:
 🔍 Detected increment: 0002
@@ -627,7 +627,7 @@ Proceeding with UPDATE mode...
 
 ### Example 2: Explicit review mode
 ```
-User: /sync-docs review 0003
+User: /specweave:sync-docs review 0003
 
 Output:
 🔍 Increment: 0003
@@ -639,7 +639,7 @@ Output:
 
 ### Example 3: Explicit update mode with increment
 ```
-User: /sync-docs update 0002
+User: /specweave:sync-docs update 0002
 
 Output:
 🔍 Increment: 0002

package/plugins/specweave/commands/translate.md

@@ -0,0 +1,425 @@
+---
+name: translate
+description: Translate SpecWeave project content to target language using LLM-native zero-cost translation
+---
+
+# /specweave:translate - Batch Translation Command
+
+You are being asked to translate SpecWeave project content to a target language.
+
+## Your Role
+
+Act as the **translator agent** to coordinate batch translation of project files.
+
+## Context
+
+SpecWeave supports **LLM-native i18n** - zero-cost translation using system prompt injection instead of external translation APIs. This command orchestrates translation of:
+
+- Project instructions (CLAUDE.md, AGENTS.md)
+- Increment specifications (.specweave/increments/*/spec.md, plan.md, tasks.md)
+- Strategic documentation (.specweave/docs/internal/)
+- Public documentation (.specweave/docs/public/)
+- Skills, agents, commands (skills/, agents/, commands/)
+
+## Supported Languages
+
+- 🇬🇧 English (en) - Default
+- 🇷🇺 Russian (ru) - Русский
+- 🇪🇸 Spanish (es) - Español
+- 🇨🇳 Chinese (zh) - 中文
+- 🇩🇪 German (de) - Deutsch
+- 🇫🇷 French (fr) - Français
+- 🇯🇵 Japanese (ja) - 日本語
+- 🇰🇷 Korean (ko) - 한국어
+- 🇧🇷 Portuguese (pt) - Português
+
+## Command Syntax
+
+```bash
+# Translate entire project
+/specweave:translate <target-language>
+
+# Translate specific scope
+/specweave:translate <target-language> --scope <scope>
+
+# Preview without writing
+/specweave:translate <target-language> --dry-run
+```
+
+**Examples**:
+```bash
+/specweave:translate ru                          # Translate all to Russian
+/specweave:translate es --scope increments       # Only increment specs
+/specweave:translate zh --scope current          # Only current increment
+/specweave:translate de --dry-run                # Preview German translation
+```
+
+## Scopes
+
+| Scope | What Gets Translated |
+|-------|---------------------|
+| `all` (default) | Everything (CLAUDE.md, specs, docs, skills, agents, commands) |
+| `increments` | All increment files (.specweave/increments/*/) |
+| `current` | Current increment only |
+| `docs` | Documentation only (.specweave/docs/) |
+| `skills` | Skills only (skills/*/) |
+| `agents` | Agents only (agents/*/) |
+| `commands` | Commands only (commands/*/) |
+| `claude-md` | CLAUDE.md only |
+
+## Your Workflow
+
+### Step 1: Parse Command
+```
+Extract:
+- Target language (required)
+- Scope (default: all)
+- Dry-run flag (default: false)
+
+Validate:
+- Target language is supported
+- Scope is valid
+- Project has translatable content
+```
+
+### Step 2: Discovery Phase
+```
+Scan project for translatable files based on scope:
+
+If scope = all:
+  - CLAUDE.md
+  - AGENTS.md (if exists)
+  - .specweave/increments/*/spec.md, plan.md, tasks.md
+  - .specweave/docs/internal/**/*.md
+  - .specweave/docs/public/**/*.md
+  - skills/*/SKILL.md
+  - agents/*/AGENT.md
+  - commands/*.md
+
+If scope = increments:
+  - .specweave/increments/*/spec.md, plan.md, tasks.md
+
+If scope = current:
+  - Get current increment from tasks status
+  - Translate only current increment files
+
+[... and so on for other scopes ...]
+
+Output:
+📊 Translation Project Discovery
+Target Language: [language] ([native name])
+Scope: [scope]
+
+Discovered Files:
+- [count] project instructions
+- [count] increment specs
+- [count] internal docs
+- [count] public docs
+- [count] skills
+- [count] agents
+- [count] commands
+
+Total: [count] files
+Estimated Time: [X] minutes
+```
+
+### Step 3: Confirm with User (unless --dry-run)
+```
+**IMPORTANT**: Always confirm before translating:
+
+"Proceed with translation? (Y/n)"
+
+If dry-run:
+  Show what WOULD be translated, exit
+If user confirms:
+  Proceed to Step 4
+If user declines:
+  Exit gracefully
+```
+
+### Step 4: Translation Execution
+```
+For each file in priority order:
+
+Priority 1 (Critical): CLAUDE.md, current increment specs
+Priority 2 (High): Internal strategy docs, public docs
+Priority 3 (Medium): Skills, agents, commands
+Priority 4 (Low): Older increments, test files
+
+Translation process per file:
+1. Read original content
+2. Use translator skill to translate
+3. Preserve:
+   - YAML frontmatter
+   - Code blocks
+   - Markdown formatting
+   - Framework terms (increment, spec.md, /specweave:*)
+   - Technical terms (TypeScript, npm, git, etc.)
+   - File paths and names
+4. Write translated content
+5. Verify formatting intact
+6. Update terminology glossary
+
+Show progress:
+[1/39] Translating CLAUDE.md... ✓
+[2/39] Translating .specweave/increments/0006/spec.md... ✓
+[3/39] Translating .specweave/docs/internal/strategy/product-vision.md... ✓
+...
+```
+
+### Step 5: Quality Validation
+```
+After all files translated:
+
+Quality Checks:
+✓ All planned files translated
+✓ Markdown structure intact
+✓ Code blocks unchanged
+✓ YAML frontmatter valid
+✓ Framework terms in English
+✓ Terminology consistent across files
+
+If any checks fail:
+  - Report failures
+  - Suggest manual review
+  - Ask if should rollback
+```
+
+### Step 6: Post-Translation Tasks
+```
+1. Update .specweave/config.json:
+   {
+     "language": "[target-language]",
+     ...
+   }
+
+2. Create translation glossary:
+   .specweave/docs/internal/translation-glossary.yaml
+
+3. Generate summary report:
+   .specweave/docs/internal/TRANSLATION-REPORT-[date].md
+
+4. Suggest next steps:
+   - Test CLI with new language
+   - Review critical files manually
+   - Update public documentation site
+```
+
+### Step 7: Output Summary
+```markdown
+✅ Translation Complete!
+
+**Target Language**: [language] ([native name])
+**Scope**: [scope]
+**Date**: [date]
+
+## Statistics
+- Files translated: [count]/[count] (100%)
+- Total content: ~[X] words
+- Framework terms preserved: [count]
+- Code blocks preserved: [count]
+- Translation time: [X] minutes
+
+## Quality Checks
+✓ All markdown formatting intact
+✓ YAML frontmatter valid
+✓ Code blocks unchanged
+✓ Framework terms in English
+✓ Terminology consistent
+
+## Files Updated
+- .specweave/config.json (language setting)
+- .specweave/docs/internal/translation-glossary.yaml (new)
+- .specweave/docs/internal/TRANSLATION-REPORT-[date].md (new)
+
+## Next Steps
+1. Test project with new language: npm run test:i18n
+2. Review critical files manually (CLAUDE.md, current spec)
+3. Update public documentation site (if applicable)
+4. Create English fallback docs if needed
+
+## Rollback
+If issues found, restore from git:
+  git checkout -- [file paths]
+```
+
+## Translation Rules (Enforce Strictly)
+
+### ✅ **Always Translate**:
+- User-facing prose
+- Documentation content
+- User stories, acceptance criteria
+- Success/error messages
+- Strategic documents
+
+### ⏸️ **Never Translate**:
+- Framework terms: increment, spec.md, plan.md, tasks.md, COMPLETION-SUMMARY.md
+- Commands: /specweave:inc, /specweave:do, /specweave:progress, /specweave:sync-docs
+- File paths: .specweave/, src/, .claude/, .cursor/, .github/
+- Technical terms: TypeScript, npm, git, API, CLI, REST, JSON, HTTP
+- SpecWeave keywords: living docs, context-manifest.yaml, PM gate, RFC
+- Code blocks (entire blocks stay in English)
+- YAML frontmatter keys (only translate values if applicable)
+
+### 🔧 **Context-Dependent**:
+- Comments in code (translate if user-facing, keep if technical)
+- Technical acronyms (usually keep in English)
+- Product names (usually keep original + translation in parentheses)
+
+## Framework Terms to Preserve
+
+**CRITICAL**: These terms MUST stay in English (part of SpecWeave framework):
+
+- `increment`
+- `spec.md`, `plan.md`, `tasks.md`, `tests.md`, `context-manifest.yaml`
+- `COMPLETION-SUMMARY.md`
+- `CLAUDE.md`, `AGENTS.md`
+- `.specweave/`, `src/`, `.claude/`, `.cursor/`, `.github/`
+- `/specweave:inc`, `/specweave:do`, `/specweave:next`, `/specweave:done`, `/specweave:progress`, `/specweave:validate`, `/specweave:sync-docs`
+- `living docs`
+- `PM gate`, `Architect`, `Tech Lead`
+- `context-manifest`
+- `RFC`, `ADR`, `PRD`, `HLD`, `LLD`
+
+**Why?** These are framework primitives - translating them would break tooling, scripts, and cross-project consistency.
+
+## Error Handling
+
+**If translation fails for a file**:
+1. Log error with file path and reason
+2. Continue with remaining files
+3. Report all errors in summary
+4. Suggest manual review for failed files
+5. Offer rollback option
+
+**If formatting breaks**:
+1. Restore original file from git
+2. Try alternative translation approach (simpler phrasing)
+3. If still fails, flag for manual translation
+4. Continue with other files
+
+## Special Considerations
+
+### YAML Frontmatter
+```yaml
+# Only translate description values, NOT keys
+---
+name: increment-planner              # ← Keep as-is
+description: Plans new increments    # ← Translate this
+allowed-tools: Read, Write, Edit     # ← Keep tools as-is
+---
+```
+
+### Code Blocks
+```typescript
+// NEVER translate code blocks
+// Even if they contain English comments
+function createIncrement(name: string) {
+  // Keep this comment in English (technical)
+  return `increment-${name}`;
+}
+```
+
+### Markdown Links
+```markdown
+<!-- Translate text, keep URLs -->
+[Read the documentation](https://spec-weave.com)
+→ [Leia a documentação](https://spec-weave.com)
+```
+
+### Framework Examples
+```markdown
+<!-- Translate explanation, keep framework terms -->
+To create an increment, run: /specweave:inc "feature-name"
+→ Para criar um increment, execute: /specweave:inc "feature-name"
+```
+
+## Integration with Translator Agent
+
+This command invokes the **translator agent** which:
+- Coordinates the batch translation workflow
+- Uses the **translator skill** for actual translation work
+- Manages consistency via terminology glossary
+- Performs quality validation
+- Generates comprehensive reports
+
+**Your job**: Follow the workflow above, using the translator agent's capabilities.
+
+## Testing After Translation
+
+**IMPORTANT**: Suggest these tests to user after translation:
+
+```bash
+# 1. Verify CLI still works
+specweave --help
+
+# 2. Test increment creation (if CLAUDE.md translated)
+/specweave:inc "test-feature"
+
+# 3. Check skill activation (if skills translated)
+# Ask questions that should trigger skills
+
+# 4. Verify agent invocation (if agents translated)
+# Use Task tool to invoke agents
+
+# 5. Run automated tests
+npm test
+npm run test:e2e
+```
+
+## Rollback Procedure
+
+If translation causes issues:
+
+```bash
+# Full rollback
+git checkout -- .
+
+# Selective rollback
+git checkout -- CLAUDE.md
+git checkout -- .specweave/increments/
+git checkout -- skills/ agents/ commands/
+
+# Reset config
+git checkout -- .specweave/config.json
+```
+
+---
+
+## Example Execution
+
+**User command**: `/specweave:translate ru`
+
+**Your response**:
+```
+📊 Translation Project Discovery
+
+Target Language: Russian (Русский)
+Scope: all
+
+Discovered Files:
+✓ CLAUDE.md
+✓ 3 increment specs (.specweave/increments/*/spec.md, plan.md, tasks.md)
+✓ 12 internal docs (.specweave/docs/internal/)
+✓ 5 public docs (.specweave/docs/public/)
+✓ 8 skills (skills/*/SKILL.md)
+✓ 3 agents (agents/*/AGENT.md)
+✓ 7 commands (commands/*.md)
+
+Total: 39 files
+Estimated Time: 30-45 minutes
+
+Framework Terms (will be preserved in English):
+- increment, spec.md, plan.md, tasks.md
+- /specweave:*, /specweave:sync-docs
+- .specweave/, src/, .claude/
+- living docs, PM gate, context-manifest
+
+Proceed with translation? (Y/n)
+```
+
+**After user confirms**: Execute translation workflow, show progress, generate report.
+
+---
+
+**Remember**: This is LLM-native translation using the current conversation - zero additional cost! The translation happens using Claude's multilingual capabilities with system prompt injection.

package/{src/commands/specweave.validate.md → plugins/specweave/commands/validate.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave.validate
+name: validate
 description: Validate SpecWeave increment with rule-based checks and optional AI quality assessment
 ---
 
@@ -733,7 +733,7 @@ All validation settings use sensible defaults. Quality assessment is prompted ea
 ## Related Commands
 
 - `/create-increment`: Create new increment (auto-validates on creation)
-- `/sync-docs`: Review strategic documentation before implementation
+- `/specweave:sync-docs`: Review strategic documentation before implementation
 - `/close-increment`: Close increment (validates before closing)
 - `/sync-github`: Sync to GitHub (validates before sync)
 

package/plugins/specweave/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "TodoWrite",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh"
+          }
+        ]
+      }
+    ]
+  }
+}