7b0f494754
feat(cli-init): propose additional agent init flow
2025-09-17 08:33:10 +10:00
4bbb52dda4
feat: rename agent instructions file
2025-09-16 13:17:49 +10:00
4a0ae49b6e
Merge pull request #64 from Fission-AI/codex/add-sorting-for-active-changes-by-completion
...
feat: add active change sorting proposal
2025-09-16 12:00:33 +10:00
5b2049aedf
feat(view): sort active changes by progress
2025-09-16 11:59:40 +10:00
332020ac6b
fix: clarify active change sorting tasks
2025-09-16 11:49:57 +10:00
8c1b580f03
feat(cli): add slash command support
2025-09-16 11:36:00 +10:00
931d10477e
Merge pull request #59 from Fission-AI/codex/rename-agent-instruction-file-to-agents.md
...
chore(changes): propose agent file rename
2025-09-16 10:26:37 +10:00
e4548bcc58
Merge pull request #60 from Fission-AI/codex/add-custom-slash-command-support-for-openspec
...
docs: add slash command support proposal
2025-09-16 08:41:10 +10:00
68fc049955
docs(changes): use proposal/apply/archive names and per-tool slash naming; add format examples and test guidance
2025-09-16 08:39:39 +10:00
4874a16495
feat(validate): propose scope-aware change validation (validate only existing artifacts)
2025-09-16 08:15:39 +10:00
3caabf86cf
docs(readme): regenerate from template via openspec update
2025-09-16 07:42:52 +10:00
d4593e4a54
docs(readme): clarify ADDED vs MODIFIED and update README template
2025-09-16 07:40:35 +10:00
0144ec2b1b
fix(changes): use ADDED for slash command requirements in cli-init and cli-update
2025-09-16 07:40:21 +10:00
ccaa5ad0b0
feat: add openspec view dashboard command
2025-09-12 21:11:42 +10:00
8eb7ebd7cd
docs: detail slash command instructions
2025-09-12 18:25:40 +10:00
9d7b44b722
chore(changes): propose agent file rename
2025-09-10 10:56:08 +10:00
44c06cc40e
Merge pull request #58 from Fission-AI/docs/align-agent-instructions
...
docs(openspec): align agent instructions and templates
2025-09-10 10:38:29 +10:00
758d91613d
docs(openspec): prefer CLI examples for listing/showing; keep rg for full-text search
2025-09-09 21:50:05 +10:00
47180e5120
docs(openspec): add TL;DR, search guidance, design skeleton, renamed example, approval gate, and examples
2025-09-09 21:36:17 +10:00
8dde1d55fc
docs(openspec): align agent instructions and templates
2025-09-09 21:26:56 +10:00
d54fcc97f2
docs: mark completed tasks for diff command removal
2025-09-09 14:07:52 +10:00
ebff738860
feat: remove diff command in favor of show command
...
The diff command added unnecessary complexity and duplicated functionality
already available through the show command. Users can now use:
- `openspec show <change>` for structured change viewing
- `openspec show <change> --json --deltas-only` for delta-only views
- Standard git diff or other tools for file comparisons
This change:
- Removes ~227 lines of code and the jest-diff dependency
- Simplifies the CLI interface
- Reduces maintenance burden
- Aligns with verb-first command structure
2025-09-09 14:05:41 +10:00
f70df96656
docs(changes): add tasks.md for improve-deterministic-tests
2025-09-06 23:20:03 +10:00
df12368f11
chore(changes): remove obsolete cli-list spec
2025-09-06 21:01:19 +10:00
acd1ca28f3
docs(changes): add deterministic tests proposal
2025-09-06 21:01:19 +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
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
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
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
95d855d641
feat(validate): improve error messages with actionable guidance
2025-08-20 00:54:34 +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
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
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
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
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
f0b1e00c65
Address review
2025-08-19 18:44:37 +10:00
Tabish Bidiwale