573afa0c65
prepare for package publish
2025-09-06 02:22:38 +10:00
665d740adb
Remove retrospective doc
2025-09-01 11:34:23 +10:00
c35dd38567
Test cursor rules
2025-08-27 21:20:37 +10:00
aa9e49612b
Merge pull request #51 from Fission-AI/updating-agent-instructions
...
feat: streamline OpenSpec agent instructions by 48%
2025-08-27 20:59:31 +10:00
36eb0bbbf5
feat: streamline OpenSpec agent instructions by 48%
...
- Restructured README.md with three-stage workflow front-loaded
- Reduced from 575 to 298 lines while adding comprehensive content
- Added clear decision trees and removed ambiguous conditions
- Documented all CLI commands with examples and debugging tips
- Added critical scenario formatting guidance (most common error)
- Created troubleshooting section with error solutions
- Updated CLAUDE.md template with streamlined, focused content
- Added "Before Any Task" checklist for context gathering
- Added spec discovery workflow to prevent duplicates
- Included tool selection matrix and best practices
2025-08-27 18:22:29 +10:00
d549cec121
Merge pull request #50 from Fission-AI/update-openspec-agent-instructions
...
Update OpenSpec agent instructions for clarity and completeness
2025-08-27 18:01:29 +10:00
1a3bfae784
feat: add comprehensive retrospective-based improvements
...
Based on OPENSPEC_COMPREHENSIVE_RETROSPECTIVE.md analysis:
Added critical missing documentation:
- Scenario formatting requirements (#### Scenario: headers) - #1 pain point
- Complete spec file structure examples with ADDED/MODIFIED sections
- Delta file location and extraction explanation
- Debugging commands (show --json --deltas-only)
- Troubleshooting section with common errors and solutions
Expanded implementation:
- Added 2 new task sections (Spec File Documentation, Troubleshooting)
- Increased from 41 to 52 total implementation tasks
- Added critical items to CLAUDE.md template tasks
This directly addresses the retrospective's top issues:
1. Scenario format documentation (marked "COMPLETELY MISSING")
2. Complete spec file examples
3. Delta detection debugging
4. Silent parsing failure explanations
2025-08-25 15:31:35 +10:00
fae08072a9
feat: add explicit implementation workflow for Stage 2
...
- Add detailed implementation steps: read docs → implement → mark complete
- Emphasize reading proposal.md, design.md, and tasks.md first
- Require immediate task completion marking (no batching)
- Add rationale: prevents jumping straight to code without context
- Update tasks to include implementation workflow documentation
This ensures agents understand and follow the complete change properly
2025-08-25 15:25:49 +10:00
07df6c97c9
feat: add comprehensive CLI documentation and spec discovery workflow
...
- Document all 9 primary OpenSpec commands with examples
- Add openspec list and list --specs prominently
- Add "Before Creating Specs" rule to check existing specs first
- Document all CLI flags (--json, --type, --skip-specs, etc.)
- Update tasks to include 9 CLI documentation items
- Add spec discovery workflow to prevent duplicate capabilities
This ensures AI agents have complete CLI knowledge and avoid spec fragmentation
2025-08-25 15:21:09 +10:00
7b13a2de03
feat: enhance proposal with agent instruction best practices
...
- Add decision clarity improvements (decision trees, remove ambiguity)
- Include agent-specific sections (tool selection, error recovery, context management)
- Restructure with clear information hierarchy
- Add comprehensive implementation tasks (6 sections, 26 tasks)
- Update design with industry best practices rationale
Based on analysis of Claude Code, Cursor, and other coding agent patterns
2025-08-24 13:36:12 +10:00
41fc14d360
fix: remove spec deltas - this is a tooling change not a capability
...
- Documentation updates are tooling/infrastructure changes
- No specs needed for OpenSpec's own instructions
- Will use --skip-specs flag when archiving
2025-08-24 13:28:22 +10:00
7c0face31b
feat: add change proposal to update OpenSpec agent instructions
...
- Create proposal for streamlining agent instructions
- Document three-stage workflow clearly
- Update CLI command documentation
- Add best practices for AI agents
- Include spec deltas for documentation requirements
2025-08-24 13:25:23 +10:00
332816cc35
Merge pull request #48 from Fission-AI/archive-changes
...
archive: apply delta-based spec updates and archive changes\n\n- adop…
2025-08-20 03:12:58 +10:00
7ced2a8791
archive: apply delta-based spec updates and archive changes\n\n- adopt-delta-based-changes: fix MODIFIED/ADDED headers; update specs; archive\n- add-zod-validation: mark cli-diff validation as ADDED; archive\n- adopt-verb-noun-cli-structure: move Flags to MODIFIED; archive\n\nAlso adjust openspec-conventions deltas to reflect existing headers.
2025-08-20 03:11:00 +10:00
a79b8b5c03
Merge pull request #47 from Fission-AI/fix-invalid-spec-files
...
fix: fix invalid files
2025-08-20 01:42:09 +10:00
52d620e40e
fix invalid files
2025-08-20 01:41:36 +10:00
22082338fd
Merge pull request #46 from Fission-AI/feat/adopt-verb-noun-cli-structure
...
Adopt verb-noun CLI structure
2025-08-20 01:06:28 +10:00
6458b6ed39
feat: adopt verb-noun CLI structure
2025-08-20 01:01:17 +10:00
01a2f5d600
Merge pull request #45 from Fission-AI/feat/improve-validation-error-messages
...
feat(validate): improve error messages with actionable guidance
2025-08-20 01:00:14 +10:00
95d855d641
feat(validate): improve error messages with actionable guidance
2025-08-20 00:54:34 +10:00
562530dfa8
Merge pull request #44 from Fission-AI/feat/add-interactive-show-command
...
feat: add unified show command with interactive selection
2025-08-20 00:17:26 +10:00
1e17cfdd0b
Address review
2025-08-20 00:14:34 +10:00
5d185ba3a8
feat: add unified show command with interactive selection
2025-08-20 00:06:19 +10:00
08b41c7bea
Merge pull request #43 from Fission-AI/feat/validate-command-interactive-selection
...
feat: add unified validate command with interactive selection and bulk operations
2025-08-19 23:23:11 +10:00
8ac50289f0
Add tests
2025-08-19 23:22:18 +10:00
1f295cec52
feat: add unified validate command with interactive selection and bulk operations
2025-08-19 22:58:17 +10:00
ad8e213cf9
Merge pull request #42 from Fission-AI/feat/bulk-validation-and-interactive-selection
...
feat: add bulk validation and interactive selection for OpenSpec commands
2025-08-19 22:35:25 +10:00
a6c1a90165
docs: consolidate retrospective documents into comprehensive analysis
2025-08-19 22:30:13 +10:00
21b5a3e680
refactor: split validation and show commands into separate change proposals
2025-08-19 22:06:09 +10:00
1bda5be96c
refactor: use single validate command with flags for better UX
2025-08-19 21:40:27 +10:00
0faf44807e
refactor: simplify change to modify existing command specs instead of creating new ones
2025-08-19 21:29:38 +10:00
f9c1d07edb
feat: add change proposal for bulk validation and interactive selection
2025-08-19 21:10:56 +10:00
2bd1a4417c
Merge pull request #41 from Fission-AI/chore/fix-change-validations
...
feat: Chore/fix change validations
2025-08-19 20:51:22 +10:00
1db19ac3d8
remove delta from proposal
2025-08-19 20:49:02 +10:00
25018786e4
chore(conventions): remove delta sections from proposals; keep deltas only in change specs; all changes pass --strict validation
2025-08-19 20:46:13 +10:00
5fd9173ad9
remove md files
2025-08-19 20:40:14 +10:00
0a611747bc
fix(change-validate): ensure delta specs emit requirements arrays; add missing Why/What sections and delta content for changes; refine removed requirement text and scenarios; all changes pass --strict validation
2025-08-19 20:31:41 +10:00
49e422724f
update test commands
2025-08-19 19:51:43 +10:00
c22d6bce1c
show completion for tasks when archiving
2025-08-19 19:48:54 +10:00
1c0dc09dc9
Merge pull request #40 from Fission-AI/update-archive-command
...
feat: Update archive command
2025-08-19 18:57:51 +10:00
f0b1e00c65
Address review
2025-08-19 18:44:37 +10:00
5fe72ddc5d
remove archive file
2025-08-19 18:26:34 +10:00
c18f3b2b2e
feat(archive): apply delta-based updates with header matching, skeleton creation, atomic writes, and per-spec counts; add requirement-block parser; add tests covering normalization, order, validation, rename+modify, and multi-spec; update proposal and tasks with product decisions
2025-08-19 18:24:27 +10:00
33344727a8
Merge pull request #39 from Fission-AI/make-commands-consistent
...
Make change and spec commands consistent (raw-first)
2025-08-18 23:26:47 +10:00
828e5ba316
chore: remove unused imports; improve no-change messaging; update README for raw-first, JSON-only filters, --long, and --no-color
2025-08-18 23:20:47 +10:00
31c57f5c0f
Follow-up: add debug logging and tests for raw-first behavior\n\n- change list: add conditional debug logging when reading tasks.md fails\n- spec tests: align with raw-first (JSON-only filters), add --no-color test, raw text passthrough, missing ID error\n- fix change show JSON mapping to stable keys (id/title) and types; ensure build passes
2025-08-18 22:47:03 +10:00
767a0053e8
Make change and spec commands consistent (raw-first)\n\n- Require explicit IDs for show; no auto-pick\n- Text mode: raw markdown passthrough; no filters\n- JSON contracts: minimal objects (no top-level arrays)\n- change show: add --deltas-only (JSON); deprecate --requirements-only\n- change list: ids by default; --long for minimal details; unified JSON { id, title, deltaCount, taskStatus }\n- spec show: raw text; JSON { id, title, overview, requirementCount, requirements, metadata }\n- spec list: ids by default; --long for minimal details; unified JSON { id, title, requirementCount }\n- Errors: console.error + process.exitCode\n- Add global --no-color\n- Update tests to new contracts
2025-08-18 22:31:17 +10:00
fd65b99c91
Merge pull request #38 from Fission-AI/add-change-commands
...
feat: add change command with show, list, and validate subcommands
2025-08-16 17:19:35 +10:00
e170df9f41
test(change): add minimal tests for change parser and command; fix async converter usage
2025-08-16 17:18:32 +10:00
b91040e8c2
chore(cli): tighten change show help text and remove unused imports
2025-08-16 17:18:32 +10:00
Tabish Bidiwale