specpulse 1.0.4__tar.gz → 1.0.5__tar.gz

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 (81) hide show
  1. {specpulse-1.0.4/specpulse.egg-info → specpulse-1.0.5}/PKG-INFO +29 -10
  2. {specpulse-1.0.4 → specpulse-1.0.5}/README.md +28 -9
  3. {specpulse-1.0.4 → specpulse-1.0.5}/pyproject.toml +1 -1
  4. {specpulse-1.0.4 → specpulse-1.0.5}/setup.py +1 -1
  5. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/__init__.py +1 -1
  6. specpulse-1.0.5/specpulse/resources/commands/claude/plan.md +184 -0
  7. specpulse-1.0.5/specpulse/resources/commands/claude/pulse.md +91 -0
  8. specpulse-1.0.5/specpulse/resources/commands/claude/spec.md +160 -0
  9. specpulse-1.0.5/specpulse/resources/commands/claude/task.md +237 -0
  10. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/resources/commands/gemini/plan.toml +13 -5
  11. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/resources/commands/gemini/pulse.toml +4 -1
  12. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/resources/commands/gemini/spec.toml +12 -4
  13. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/resources/commands/gemini/task.toml +17 -5
  14. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/resources/memory/constitution.md +2 -2
  15. specpulse-1.0.5/specpulse/resources/scripts/pulse-init.ps1 +186 -0
  16. specpulse-1.0.5/specpulse/resources/scripts/pulse-init.py +171 -0
  17. specpulse-1.0.5/specpulse/resources/scripts/pulse-init.sh +96 -0
  18. specpulse-1.0.5/specpulse/resources/scripts/pulse-plan.ps1 +251 -0
  19. specpulse-1.0.5/specpulse/resources/scripts/pulse-plan.py +191 -0
  20. specpulse-1.0.5/specpulse/resources/scripts/pulse-plan.sh +127 -0
  21. specpulse-1.0.5/specpulse/resources/scripts/pulse-spec.ps1 +185 -0
  22. specpulse-1.0.5/specpulse/resources/scripts/pulse-spec.py +167 -0
  23. specpulse-1.0.5/specpulse/resources/scripts/pulse-spec.sh +104 -0
  24. specpulse-1.0.5/specpulse/resources/scripts/pulse-task.ps1 +263 -0
  25. specpulse-1.0.5/specpulse/resources/scripts/pulse-task.py +237 -0
  26. specpulse-1.0.5/specpulse/resources/scripts/pulse-task.sh +137 -0
  27. specpulse-1.0.5/specpulse/resources/templates/plan.md +206 -0
  28. specpulse-1.0.5/specpulse/resources/templates/spec.md +125 -0
  29. specpulse-1.0.5/specpulse/resources/templates/task.md +164 -0
  30. {specpulse-1.0.4 → specpulse-1.0.5/specpulse.egg-info}/PKG-INFO +29 -10
  31. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse.egg-info/SOURCES.txt +11 -0
  32. specpulse-1.0.5/tests/test_cross_platform_scripts.py +317 -0
  33. specpulse-1.0.5/tests/test_powershell_scripts.py +464 -0
  34. specpulse-1.0.5/tests/test_python_scripts.py +470 -0
  35. specpulse-1.0.4/specpulse/resources/commands/claude/plan.md +0 -73
  36. specpulse-1.0.4/specpulse/resources/commands/claude/pulse.md +0 -52
  37. specpulse-1.0.4/specpulse/resources/commands/claude/spec.md +0 -81
  38. specpulse-1.0.4/specpulse/resources/commands/claude/task.md +0 -78
  39. specpulse-1.0.4/specpulse/resources/scripts/pulse-init.sh +0 -37
  40. specpulse-1.0.4/specpulse/resources/scripts/pulse-plan.sh +0 -26
  41. specpulse-1.0.4/specpulse/resources/scripts/pulse-spec.sh +0 -29
  42. specpulse-1.0.4/specpulse/resources/scripts/pulse-task.sh +0 -23
  43. specpulse-1.0.4/specpulse/resources/templates/plan.md +0 -351
  44. specpulse-1.0.4/specpulse/resources/templates/spec.md +0 -291
  45. specpulse-1.0.4/specpulse/resources/templates/task.md +0 -143
  46. {specpulse-1.0.4 → specpulse-1.0.5}/LICENSE +0 -0
  47. {specpulse-1.0.4 → specpulse-1.0.5}/MANIFEST.in +0 -0
  48. {specpulse-1.0.4 → specpulse-1.0.5}/requirements.txt +0 -0
  49. {specpulse-1.0.4 → specpulse-1.0.5}/setup.cfg +0 -0
  50. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/cli/__init__.py +0 -0
  51. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/cli/main.py +0 -0
  52. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/core/__init__.py +0 -0
  53. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/core/specpulse.py +0 -0
  54. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/core/validator.py +0 -0
  55. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/resources/memory/context.md +0 -0
  56. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/resources/memory/decisions.md +0 -0
  57. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/utils/__init__.py +0 -0
  58. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/utils/console.py +0 -0
  59. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse/utils/git_utils.py +0 -0
  60. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse.egg-info/dependency_links.txt +0 -0
  61. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse.egg-info/entry_points.txt +0 -0
  62. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse.egg-info/not-zip-safe +0 -0
  63. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse.egg-info/requires.txt +0 -0
  64. {specpulse-1.0.4 → specpulse-1.0.5}/specpulse.egg-info/top_level.txt +0 -0
  65. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_100_coverage.py +0 -0
  66. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_100_percent_coverage.py +0 -0
  67. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_ai_commands.py +0 -0
  68. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_cli.py +0 -0
  69. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_cli_advanced.py +0 -0
  70. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_cli_comprehensive.py +0 -0
  71. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_command_integration.py +0 -0
  72. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_complete_coverage.py +0 -0
  73. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_console_advanced.py +0 -0
  74. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_console_comprehensive.py +0 -0
  75. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_core.py +0 -0
  76. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_core_comprehensive.py +0 -0
  77. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_full_coverage.py +0 -0
  78. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_gemini_commands.py +0 -0
  79. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_git_utils.py +0 -0
  80. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_git_utils_comprehensive.py +0 -0
  81. {specpulse-1.0.4 → specpulse-1.0.5}/tests/test_validator_comprehensive.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: specpulse
3
- Version: 1.0.4
3
+ Version: 1.0.5
4
4
  Summary: Specification-Driven Development Framework
5
5
  Home-page: https://github.com/specpulse
6
6
  Author: SpecPulse
@@ -66,11 +66,12 @@ Dynamic: requires-python
66
66
 
67
67
  SpecPulse revolutionizes AI-assisted development by enforcing a **specification-first approach**. Instead of jumping straight into code, SpecPulse ensures every feature starts with clear specifications, validated plans, and tracked tasks - guaranteeing quality from day one.
68
68
 
69
- > **Latest Update (v1.0.4)**:
70
- > - ✅ **100% Working AI Commands**: Both Claude and Gemini commands now properly support arguments
71
- > - ✅ **95% Test Coverage**: Comprehensive test suite with 193+ tests
72
- > - ✅ **Fixed Command Formats**: Claude uses `$ARGUMENTS`, Gemini uses `{{args}}`
73
- > - ✅ **Enhanced Documentation**: Clearer examples and usage instructions
69
+ > **Latest Update (v1.0.5)**:
70
+ > - ✅ **Complete Cross-Platform Support**: Works seamlessly on Windows, Linux, and macOS
71
+ > - ✅ **100% Test Success Rate**: Comprehensive test suite with 37+ tests across all platforms
72
+ > - ✅ **Python & PowerShell Scripts**: Full script compatibility beyond bash
73
+ > - ✅ **Automatic Platform Detection**: AI commands choose the right script automatically
74
+ > - ✅ **Unicode Support**: Full international character support (≤, ≥, →, ←)
74
75
 
75
76
  ### Why SpecPulse?
76
77
 
@@ -91,6 +92,13 @@ pip install specpulse --upgrade
91
92
  - Git (optional, for version control features)
92
93
  - Claude or Gemini CLI (for AI integration)
93
94
 
95
+ **Cross-Platform Support:**
96
+ - **Windows**: Python scripts + PowerShell fallback + Bash compatibility
97
+ - **Linux**: Python scripts + Bash fallback
98
+ - **macOS**: Python scripts + Bash fallback
99
+ - **Source Installation**: Works perfectly from source code (not just PyPI)
100
+ - **Automatic Detection**: AI commands automatically detect OS and choose appropriate script
101
+
94
102
  ## 🚀 Quick Start
95
103
 
96
104
  ### Step 1: Initialize Your Project
@@ -248,6 +256,13 @@ Stop guessing what users want:
248
256
 
249
257
  Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
250
258
 
259
+ **Cross-Platform Script Execution:**
260
+ - **Windows**: PowerShell (.ps1) → Python (.py) → Bash (.sh) fallback
261
+ - **Linux/macOS**: Python (.py) → Bash (.sh) fallback
262
+ - **Automatic Detection**: AI commands detect OS and choose appropriate script
263
+ - **Universal Compatibility**: Works whether installed via PyPI or source code
264
+ - **Unicode Support**: Full international character support (≤, ≥, →, ←)
265
+
251
266
  ```bash
252
267
  /pulse user-authentication # Start new feature with name
253
268
  /spec create OAuth2 login # Create specification with description
@@ -262,10 +277,14 @@ Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
262
277
 
263
278
  **Behind the Scenes:**
264
279
  - Commands capture arguments using `$ARGUMENTS` variable
265
- - Shell scripts in `scripts/` folder process the arguments
266
- - AI reads templates from `templates/` folder
280
+ - **Multi-platform scripts** in `resources/scripts/` folder process the arguments:
281
+ - `pulse-*.py` - Python scripts (universal)
282
+ - `pulse-*.ps1` - PowerShell scripts (Windows)
283
+ - `pulse-*.sh` - Bash scripts (Linux/macOS)
284
+ - AI reads templates from `resources/templates/` folder
267
285
  - Results are saved in `specs/`, `plans/`, `tasks/` folders
268
286
  - Memory system tracks progress in `memory/` folder
287
+ - **Automatic platform detection** ensures the right script runs on each OS
269
288
 
270
289
  **Claude vs Gemini:**
271
290
  - **Claude**: Uses Markdown command files (`.claude/commands/*.md`) with YAML frontmatter
@@ -438,8 +457,8 @@ Built with inspiration from:
438
457
  ## 🚦 Project Status
439
458
 
440
459
  [![Build Status](https://img.shields.io/badge/build-passing-brightgreen)](https://github.com/specpulse/specpulse)
441
- [![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)](https://github.com/specpulse/specpulse)
442
- [![Tests](https://img.shields.io/badge/tests-193%20passed-brightgreen)](https://github.com/specpulse/specpulse)
460
+ [![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)](https://github.com/specpulse/specpulse)
461
+ [![Tests](https://img.shields.io/badge/tests-37%2B%20passed-brightgreen)](https://github.com/specpulse/specpulse)
443
462
  [![Maintainability](https://img.shields.io/badge/maintainability-A-brightgreen)](https://github.com/specpulse/specpulse)
444
463
 
445
464
  ---
@@ -21,11 +21,12 @@
21
21
 
22
22
  SpecPulse revolutionizes AI-assisted development by enforcing a **specification-first approach**. Instead of jumping straight into code, SpecPulse ensures every feature starts with clear specifications, validated plans, and tracked tasks - guaranteeing quality from day one.
23
23
 
24
- > **Latest Update (v1.0.4)**:
25
- > - ✅ **100% Working AI Commands**: Both Claude and Gemini commands now properly support arguments
26
- > - ✅ **95% Test Coverage**: Comprehensive test suite with 193+ tests
27
- > - ✅ **Fixed Command Formats**: Claude uses `$ARGUMENTS`, Gemini uses `{{args}}`
28
- > - ✅ **Enhanced Documentation**: Clearer examples and usage instructions
24
+ > **Latest Update (v1.0.5)**:
25
+ > - ✅ **Complete Cross-Platform Support**: Works seamlessly on Windows, Linux, and macOS
26
+ > - ✅ **100% Test Success Rate**: Comprehensive test suite with 37+ tests across all platforms
27
+ > - ✅ **Python & PowerShell Scripts**: Full script compatibility beyond bash
28
+ > - ✅ **Automatic Platform Detection**: AI commands choose the right script automatically
29
+ > - ✅ **Unicode Support**: Full international character support (≤, ≥, →, ←)
29
30
 
30
31
  ### Why SpecPulse?
31
32
 
@@ -46,6 +47,13 @@ pip install specpulse --upgrade
46
47
  - Git (optional, for version control features)
47
48
  - Claude or Gemini CLI (for AI integration)
48
49
 
50
+ **Cross-Platform Support:**
51
+ - **Windows**: Python scripts + PowerShell fallback + Bash compatibility
52
+ - **Linux**: Python scripts + Bash fallback
53
+ - **macOS**: Python scripts + Bash fallback
54
+ - **Source Installation**: Works perfectly from source code (not just PyPI)
55
+ - **Automatic Detection**: AI commands automatically detect OS and choose appropriate script
56
+
49
57
  ## 🚀 Quick Start
50
58
 
51
59
  ### Step 1: Initialize Your Project
@@ -203,6 +211,13 @@ Stop guessing what users want:
203
211
 
204
212
  Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
205
213
 
214
+ **Cross-Platform Script Execution:**
215
+ - **Windows**: PowerShell (.ps1) → Python (.py) → Bash (.sh) fallback
216
+ - **Linux/macOS**: Python (.py) → Bash (.sh) fallback
217
+ - **Automatic Detection**: AI commands detect OS and choose appropriate script
218
+ - **Universal Compatibility**: Works whether installed via PyPI or source code
219
+ - **Unicode Support**: Full international character support (≤, ≥, →, ←)
220
+
206
221
  ```bash
207
222
  /pulse user-authentication # Start new feature with name
208
223
  /spec create OAuth2 login # Create specification with description
@@ -217,10 +232,14 @@ Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
217
232
 
218
233
  **Behind the Scenes:**
219
234
  - Commands capture arguments using `$ARGUMENTS` variable
220
- - Shell scripts in `scripts/` folder process the arguments
221
- - AI reads templates from `templates/` folder
235
+ - **Multi-platform scripts** in `resources/scripts/` folder process the arguments:
236
+ - `pulse-*.py` - Python scripts (universal)
237
+ - `pulse-*.ps1` - PowerShell scripts (Windows)
238
+ - `pulse-*.sh` - Bash scripts (Linux/macOS)
239
+ - AI reads templates from `resources/templates/` folder
222
240
  - Results are saved in `specs/`, `plans/`, `tasks/` folders
223
241
  - Memory system tracks progress in `memory/` folder
242
+ - **Automatic platform detection** ensures the right script runs on each OS
224
243
 
225
244
  **Claude vs Gemini:**
226
245
  - **Claude**: Uses Markdown command files (`.claude/commands/*.md`) with YAML frontmatter
@@ -393,8 +412,8 @@ Built with inspiration from:
393
412
  ## 🚦 Project Status
394
413
 
395
414
  [![Build Status](https://img.shields.io/badge/build-passing-brightgreen)](https://github.com/specpulse/specpulse)
396
- [![Coverage](https://img.shields.io/badge/coverage-95%25-brightgreen)](https://github.com/specpulse/specpulse)
397
- [![Tests](https://img.shields.io/badge/tests-193%20passed-brightgreen)](https://github.com/specpulse/specpulse)
415
+ [![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)](https://github.com/specpulse/specpulse)
416
+ [![Tests](https://img.shields.io/badge/tests-37%2B%20passed-brightgreen)](https://github.com/specpulse/specpulse)
398
417
  [![Maintainability](https://img.shields.io/badge/maintainability-A-brightgreen)](https://github.com/specpulse/specpulse)
399
418
 
400
419
  ---
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "specpulse"
7
- version = "1.0.4"
7
+ version = "1.0.5"
8
8
  description = "Specification-Driven Development Framework"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
@@ -11,7 +11,7 @@ long_description = (this_directory / "README.md").read_text(encoding="utf-8")
11
11
 
12
12
  setup(
13
13
  name="specpulse",
14
- version="1.0.0",
14
+ version="1.0.5",
15
15
  author="SpecPulse",
16
16
  author_email="",
17
17
  description="Next-Generation Specification-Driven Development Framework",
@@ -3,7 +3,7 @@ SpecPulse: Specification-Driven Development Framework
3
3
  Built for the AI era
4
4
  """
5
5
 
6
- __version__ = "1.0.4"
6
+ __version__ = "1.0.5"
7
7
  __author__ = "SpecPulse"
8
8
  __url__ = "https://github.com/specpulse"
9
9
 
@@ -0,0 +1,184 @@
1
+ ---
2
+ name: plan
3
+ description: Generate or validate implementation plans using AI-optimized templates
4
+ allowed_tools:
5
+ - Read
6
+ - Write
7
+ - Edit
8
+ - Bash
9
+ - TodoWrite
10
+ ---
11
+
12
+ # /plan Command
13
+
14
+ Generate implementation plans from specifications following SpecPulse methodology with constitutional compliance and AI-optimized templates.
15
+
16
+ ## Usage
17
+ ```
18
+ /plan [action] [feature-directory]
19
+ ```
20
+
21
+ Actions: `generate`, `validate`, `optimize` (defaults to `generate`)
22
+
23
+ ## Implementation
24
+
25
+ When called with `/plan $ARGUMENTS`, I will:
26
+
27
+ 1. **Parse arguments** and determine action:
28
+ - If `validate`: Check plan against constitutional gates
29
+ - If `optimize`: Improve existing plan complexity
30
+ - Otherwise: Generate new plan
31
+
32
+ 2. **For `/plan generate` or `/plan`:**
33
+ a. **Find and validate specification** from current context or provided directory
34
+
35
+ b. **Enhanced validation** using cross-platform script:
36
+ ```bash
37
+ # Cross-platform detection
38
+ if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
39
+ powershell scripts/pulse-plan.ps1 "$FEATURE_DIR"
40
+ else
41
+ bash scripts/pulse-plan.sh "$FEATURE_DIR" || python scripts/pulse-plan.py "$FEATURE_DIR"
42
+ fi
43
+ ```
44
+
45
+ c. **Run Constitutional Phase Gates** (Article VII):
46
+ - Simplicity Gate: ≤3 modules justification
47
+ - Anti-Abstraction Gate: Direct framework usage
48
+ - Test-First Gate: Tests before implementation
49
+ - Integration-First Gate: Real services over mocks
50
+ - Research Gate: Technology choices documented
51
+
52
+ d. **Generate AI-optimized plan** using template variables:
53
+ ```markdown
54
+ # Implementation Plan: {{ feature_name }}
55
+ ## Specification Reference
56
+ - **Spec ID**: SPEC-{{ feature_id }}
57
+ - **Generated**: {{ date }}
58
+ ```
59
+
60
+ e. **Generate comprehensive sections**:
61
+ - Technology stack with performance implications
62
+ - Architecture overview with component relationships
63
+ - Implementation phases with timeline estimates
64
+ - API contracts with authentication requirements
65
+ - Data models with validation rules
66
+ - Testing strategy with coverage targets
67
+ - Security considerations with compliance requirements
68
+ - Deployment strategy with rollback plans
69
+
70
+ f. **Complexity tracking** (Article VII):
71
+ - Document all complexity exceptions with justifications
72
+ - Create mitigation strategies for each exception
73
+ - Track optimization opportunities
74
+
75
+ g. **Write optimized plan** to `plans/XXX-feature/plan.md`
76
+
77
+ 3. **For `/plan validate`:**
78
+ - **Enhanced validation** using cross-platform script:
79
+ ```bash
80
+ # Cross-platform detection
81
+ if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
82
+ powershell scripts/pulse-plan.ps1 "$FEATURE_DIR"
83
+ else
84
+ bash scripts/pulse-plan.sh "$FEATURE_DIR" || python scripts/pulse-plan.py "$FEATURE_DIR"
85
+ fi
86
+ ```
87
+ - Verify all constitutional gates are addressed
88
+ - Check complexity exceptions have proper justifications
89
+ - Validate test-first approach is documented
90
+ - Ensure integration strategy uses real services
91
+ - Report detailed validation results
92
+
93
+ 4. **For `/plan optimize`:**
94
+ - **Read existing plan** and analyze complexity
95
+ - **Identify optimization opportunities**:
96
+ - Module consolidation opportunities
97
+ - Abstraction layer removal candidates
98
+ - Simplification strategies
99
+ - **Generate optimization recommendations**
100
+ - **Update plan** with reduced complexity
101
+
102
+ ## Constitutional Phase Gates (Phase -1)
103
+
104
+ **Must pass before implementation:**
105
+
106
+ ### Article VII: Simplicity Gate
107
+ - [ ] Using ≤3 projects/modules for initial implementation
108
+ - [ ] No future-proofing without documented need
109
+ - [ ] Direct framework usage (no unnecessary wrappers)
110
+ - [ ] Single model representation per concept
111
+
112
+ ### Article VII: Anti-Abstraction Gate
113
+ - [ ] Using framework features directly
114
+ - [ ] No unnecessary abstraction layers
115
+ - [ ] Clear, simple interfaces
116
+ - [ ] Avoiding premature optimization
117
+
118
+ ### Article III: Test-First Gate
119
+ - [ ] Test specifications written
120
+ - [ ] Tests reviewed and approved
121
+ - [ ] Tests confirmed to FAIL before implementation
122
+ - [ ] TDD cycle planned (Red-Green-Refactor)
123
+
124
+ ### Article VIII: Integration-First Gate
125
+ - [ ] Contract tests defined
126
+ - [ ] Using real services over mocks
127
+ - [ ] Production-like test environment planned
128
+ - [ ] End-to-end test scenarios identified
129
+
130
+ ### Article VI: Research Gate
131
+ - [ ] Library options researched
132
+ - [ ] Performance implications documented
133
+ - [ ] Security considerations analyzed
134
+ - [ ] Trade-offs documented
135
+
136
+ ## Examples
137
+
138
+ ### Generate plan with validation
139
+ ```
140
+ User: /plan generate
141
+ ```
142
+ I will:
143
+ - Run: `bash scripts/pulse-plan.sh "$FEATURE_DIR"`
144
+ - Validate: Constitutional gates compliance
145
+ - Create: AI-optimized plan with template variables
146
+ - Output: `CONSTITUTIONAL_GATES_STATUS=PENDING`
147
+
148
+ ### Validate existing plan
149
+ ```
150
+ User: /plan validate
151
+ ```
152
+ I will run comprehensive validation:
153
+ ```
154
+ PLAN_FILE=plans/001-user-authentication/plan.md
155
+ CONSTITUTIONAL_GATES_STATUS=COMPLETED
156
+ MISSING_SECTIONS=0
157
+ STATUS=validation_complete
158
+ ```
159
+
160
+ ### Optimize plan complexity
161
+ ```
162
+ User: /plan optimize
163
+ ```
164
+ I will analyze and recommend complexity reductions.
165
+
166
+ ## Enhanced Features
167
+
168
+ - **AI-optimized templates** with Jinja2-style variables
169
+ - **Cross-platform script execution** with automatic detection
170
+ - **Enhanced script integration** for Bash, PowerShell, and Python
171
+ - **Constitutional compliance tracking** with gate status
172
+ - **Complexity exception management** with justifications
173
+ - **Performance and security considerations** integrated
174
+ - **Integration-first approach** with real service usage
175
+ - **Detailed validation reporting** with specific recommendations
176
+ - **Platform-agnostic operation** for any development environment
177
+
178
+ ## Error Handling
179
+
180
+ - Specification existence validation
181
+ - Constitutional gate compliance checking
182
+ - Template structure validation
183
+ - Directory structure verification
184
+ - Feature context auto-discovery
@@ -0,0 +1,91 @@
1
+ ---
2
+ name: pulse
3
+ description: Initialize a new feature with SpecPulse framework
4
+ allowed_tools:
5
+ - Bash
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ - TodoWrite
10
+ ---
11
+
12
+ # /pulse Command
13
+
14
+ Initialize a new feature following SpecPulse methodology with constitutional compliance.
15
+
16
+ ## Usage
17
+ ```
18
+ /pulse <feature-name> [feature-id]
19
+ ```
20
+
21
+ ## Implementation
22
+
23
+ When called with `/pulse $ARGUMENTS`, I will:
24
+
25
+ 1. **Validate arguments** and extract feature name + optional ID
26
+ 2. **Run initialization script** with cross-platform detection:
27
+ - **Windows**: `powershell scripts/pulse-init.ps1 "$FEATURE_NAME" "$OPTIONAL_ID"`
28
+ - **Linux/macOS**: `bash scripts/pulse-init.sh "$FEATURE_NAME" "$OPTIONAL_ID"`
29
+ - **Python Fallback**: `python scripts/pulse-init.py "$FEATURE_NAME" "$OPTIONAL_ID"`
30
+ 3. **Create complete feature structure**:
31
+ - Generate feature ID (001, 002, etc.) or use provided ID
32
+ - Create sanitized branch name: `ID-feature-name`
33
+ - Create directories: `specs/ID-feature-name/`, `plans/ID-feature-name/`, `tasks/ID-feature-name/`
34
+ - Copy AI-optimized templates to feature directories
35
+ - Update `memory/context.md` with current feature metadata
36
+ - Create and switch to git branch if in git repository
37
+
38
+ 4. **Validate structure** and report comprehensive status
39
+ 5. **Create todo list** for tracking feature development progress
40
+
41
+ ## Constitutional Compliance
42
+
43
+ **Article I: Simplicity**
44
+ - [ ] Feature name is clear and specific
45
+ - [ ] No unnecessary abstractions in initial structure
46
+ - [ ] Single responsibility per feature
47
+
48
+ **Article II: Anti-Abstraction**
49
+ - [ ] Direct template usage (no wrapper layers)
50
+ - [ ] Minimal initial structure
51
+ - [ ] Framework-ready files
52
+
53
+ ## Example
54
+ ```
55
+ User: /pulse user-authentication-oauth2
56
+ ```
57
+
58
+ I will:
59
+ - Run: `bash scripts/pulse-init.sh "user-authentication-oauth2"`
60
+ - Create: `specs/001-user-authentication-oauth2/spec.md`
61
+ - Create: `plans/001-user-authentication-oauth2/plan.md`
62
+ - Create: `tasks/001-user-authentication-oauth2/tasks.md`
63
+ - Branch: `001-user-authentication-oauth2`
64
+ - Status: `STATUS=initialized, BRANCH_NAME=001-user-authentication-oauth2`
65
+
66
+ ## Error Handling
67
+
68
+ Enhanced validation includes:
69
+ - Feature name sanitization (alphanumeric, hyphens only)
70
+ - Directory creation validation
71
+ - Template existence verification
72
+ - Git repository validation
73
+ - Context file management
74
+
75
+ ## Next Steps (Constitutional Order)
76
+
77
+ 1. **Phase -1**: Use `/spec` to create specification with constitutional gates
78
+ 2. **Phase 0**: Use `/plan` to generate implementation plan with complexity tracking
79
+ 3. **Phase 1**: Use `/task` to break down into executable tasks
80
+ 4. **Implementation**: Begin development following constitutional principles
81
+
82
+ ## Integration Features
83
+
84
+ - **Automatic context tracking** in `memory/context.md`
85
+ - **Enhanced error reporting** with specific failure reasons
86
+ - **Git integration** with branch management
87
+ - **Template validation** before copying
88
+ - **Todo list creation** for progress tracking
89
+ - **Cross-platform script execution** with automatic detection
90
+ - **Multiple language support**: Bash, PowerShell, Python
91
+ - **Platform-agnostic operation** for any development environment
@@ -0,0 +1,160 @@
1
+ ---
2
+ name: spec
3
+ description: Create or manage feature specifications using AI-optimized templates
4
+ allowed_tools:
5
+ - Read
6
+ - Write
7
+ - Edit
8
+ - Bash
9
+ - TodoWrite
10
+ ---
11
+
12
+ # /spec Command
13
+
14
+ Create, update, or validate feature specifications using SpecPulse methodology with AI-optimized templates.
15
+
16
+ ## Usage
17
+ ```
18
+ /spec [action] [description|feature-name]
19
+ ```
20
+
21
+ Actions: `create`, `update`, `validate`, `clarify` (defaults to `create`)
22
+
23
+ ## Implementation
24
+
25
+ When called with `/spec $ARGUMENTS`, I will:
26
+
27
+ 1. **Parse arguments** to determine action:
28
+ - If starts with `create`: Generate new specification
29
+ - If starts with `update`: Modify existing specification
30
+ - If starts with `validate`: Check specification completeness
31
+ - If starts with `clarify`: Address [NEEDS CLARIFICATION] markers
32
+ - If no action specified: Default to `create` with full arguments as description
33
+
34
+ 2. **For `/spec create [description]` or `/spec [description]`:**
35
+ - Read AI-optimized template from `templates/spec.md`
36
+ - Parse the description to identify:
37
+ - Functional requirements (Must/Should/Could/Won't have)
38
+ - User stories with testable acceptance criteria
39
+ - Technical specifications and constraints
40
+ - Success metrics and out-of-scope items
41
+ - Generate specification using Jinja2-style template variables:
42
+ ```markdown
43
+ # Specification: {{ feature_name }}
44
+ ## Metadata
45
+ - **ID**: SPEC-{{ feature_id }}
46
+ - **Created**: {{ date }}
47
+ ```
48
+ - Mark any uncertainties with `[NEEDS CLARIFICATION: specific question]`
49
+ - Find current feature directory from context or create new
50
+ - Write specification to `specs/ID-feature-name/spec.md`
51
+ - Run enhanced validation with cross-platform detection:
52
+ - **Windows**: `powershell scripts/pulse-spec.ps1 "$FEATURE_DIR"`
53
+ - **Linux/macOS**: `bash scripts/pulse-spec.sh "$FEATURE_DIR"`
54
+ - **Python Fallback**: `python scripts/pulse-spec.py "$FEATURE_DIR"`
55
+
56
+ 3. **For `/spec update`:**
57
+ - Read existing specification from current context
58
+ - Parse update requests and identify sections to modify
59
+ - Update content while preserving AI-friendly template structure
60
+ - Remove resolved `[NEEDS CLARIFICATION]` markers
61
+ - Run validation to ensure completeness
62
+
63
+ 4. **For `/spec validate`:**
64
+ - Read current specification
65
+ - Check all required sections using enhanced validation:
66
+ ```bash
67
+ # Cross-platform detection
68
+ if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
69
+ powershell scripts/pulse-spec.ps1 "$FEATURE_DIR"
70
+ else
71
+ bash scripts/pulse-spec.sh "$FEATURE_DIR" || python scripts/pulse-spec.py "$FEATURE_DIR"
72
+ fi
73
+ ```
74
+ - Count `[NEEDS CLARIFICATION]` markers
75
+ - Verify acceptance criteria follow Given-When-Then format
76
+ - Check constitutional compliance indicators
77
+ - Report detailed validation results
78
+
79
+ 5. **For `/spec clarify`:**
80
+ - Find all `[NEEDS CLARIFICATION]` markers
81
+ - Address each uncertainty with user input
82
+ - Update specification with resolved information
83
+ - Remove clarification markers
84
+ - Re-run validation
85
+
86
+ ## Examples
87
+
88
+ ### Creating a new specification
89
+ ```
90
+ User: /spec create user authentication system with OAuth2 and JWT tokens
91
+ ```
92
+ I will create a comprehensive specification using AI-optimized templates with:
93
+ - Jinja2-style variables for AI processing
94
+ - Constitutional compliance sections
95
+ - Testable acceptance criteria
96
+ - Automated validation
97
+
98
+ ### Updating existing specification
99
+ ```
100
+ User: /spec update add password complexity requirements
101
+ ```
102
+ I will read the current spec, update password requirements, and validate changes.
103
+
104
+ ### Validating specification
105
+ ```
106
+ User: /spec validate
107
+ ```
108
+ I will run enhanced validation with detailed reporting:
109
+ ```
110
+ SPEC_FILE=specs/001-user-authentication/spec.md
111
+ CLARIFICATIONS_NEEDED=3
112
+ MISSING_SECTIONS=0
113
+ STATUS=validation_complete
114
+ ```
115
+
116
+ ### Addressing clarifications
117
+ ```
118
+ User: /spec clarify
119
+ ```
120
+ I will systematically address all [NEEDS CLARIFICATION] markers.
121
+
122
+ ## Enhanced Template Structure
123
+
124
+ The AI-optimized specification template includes:
125
+ - **Metadata**: Template variables for AI processing
126
+ - **Constitutional Gates**: Pre-implementation validation
127
+ - **Functional Requirements**: Structured Must/Should/Could/Won't
128
+ - **User Stories**: Given-When-Then acceptance criteria
129
+ - **Validation Checklist**: Automated completeness checks
130
+ - **Integration Points**: AI command workflow guidance
131
+
132
+ ## Constitutional Compliance
133
+
134
+ **Article III: Test-First**
135
+ - [ ] Acceptance criteria written before implementation
136
+ - [ ] Test scenarios clearly defined
137
+ - [ ] Integration points identified
138
+
139
+ **Article VI: Research**
140
+ - [ ] Technology choices documented
141
+ - [ ] Security considerations addressed
142
+ - [ ] Performance requirements specified
143
+
144
+ ## Enhanced Error Handling
145
+
146
+ - Template existence validation
147
+ - Feature directory auto-discovery
148
+ - Required sections validation
149
+ - Acceptance criteria format checking
150
+ - Clarification marker tracking
151
+
152
+ ## Integration Features
153
+
154
+ - **Cross-platform script execution** with automatic detection
155
+ - **Enhanced script integration** with Bash, PowerShell, and Python support
156
+ - **Template variable processing** for AI optimization
157
+ - **Automated validation** with detailed reporting
158
+ - **Context-aware operation** using memory/context.md
159
+ - **Progress tracking** with todo list integration
160
+ - **Platform-agnostic operation** for Windows, Linux, and macOS