Tabish Bidiwale
adfcc65b9f
docs(readme): simplify getting started with clearer AI workflow steps
2025-09-07 04:41:56 +10:00
Tabish Bidiwale
590541277d
docs(readme): fix getting started to show AI-native workflow, not manual file creation
2025-09-07 04:36:03 +10:00
Tabish Bidiwale
14e2cc628a
docs(readme): enhance for public release with why, workflow diagram, AI integration, comparisons
2025-09-07 04:26:44 +10:00
Tabish Bidiwale
299171c5cb
docs(readme): add CI, npm, Node, license, conventional commits badges
2025-09-07 03:57:33 +10:00
Tabish Bidiwale
bb6aae0205
docs(license): add MIT license file
2025-09-07 03:32:27 +10:00
Tabish Bidiwale
23c0ab6358
docs(readme): improve onboarding, verb-first commands, examples, JSON usage, troubleshooting
2025-09-07 03:20:34 +10:00
Tabish Bidiwale
02fe5b3547
Merge pull request #56 from Fission-AI/fix-tests
...
fix(test): resolve CI test failures with proper build setup
v0.1.0
2025-09-07 02:34:13 +10:00
Tabish Bidiwale
57216a7824
refactor(test): use vitest globalSetup for build instead of per-test builds
2025-09-07 02:16:17 +10:00
Tabish Bidiwale
6e210cf084
fix(test): ensure dist exists before spawning CLI subprocesses
2025-09-07 02:13:21 +10:00
Tabish Bidiwale
5c6ae8e407
Merge pull request #55 from Fission-AI/fix-tests
...
fix(ci): ensure build runs before tests in workflows
2025-09-07 02:04:04 +10:00
Tabish Bidiwale
5376030421
fix(ci): simplify to single Node version for faster CI
2025-09-07 01:56:00 +10:00
Tabish Bidiwale
7d735eb2d8
fix(ci): ensure build runs before tests in workflows
2025-09-07 01:45:11 +10:00
Tabish Bidiwale
4d55e9ac6d
chore(ci): use NODE_AUTH_TOKEN auth, add debug, build before tests
2025-09-07 01:23:32 +10:00
Tabish Bidiwale
9d674b22a3
Fix provenance
2025-09-07 01:13:23 +10:00
Tabish Bidiwale
96458ced1f
Update actions workflow
2025-09-07 01:01:55 +10:00
Tabish Bidiwale
3d8f2a5974
update workflow
2025-09-07 00:31:37 +10:00
Tabish Bidiwale
006676c973
chore(test): clarify vitest worker note and newline
2025-09-06 23:27:49 +10:00
Tabish Bidiwale
63f45c0fcf
test(commands): isolate change command tests via temp fixtures
2025-09-06 23:27:42 +10:00
Tabish Bidiwale
522126a6ee
fix(utils): harden item discovery for determinism
2025-09-06 23:27:33 +10:00
Tabish Bidiwale
23b8030494
fix(change): only list active changes with proposal.md
2025-09-06 23:26:51 +10:00
Tabish Bidiwale
f70df96656
docs(changes): add tasks.md for improve-deterministic-tests
2025-09-06 23:20:03 +10:00
Tabish Bidiwale
df12368f11
chore(changes): remove obsolete cli-list spec
2025-09-06 21:01:19 +10:00
Tabish Bidiwale
acd1ca28f3
docs(changes): add deterministic tests proposal
2025-09-06 21:01:19 +10:00
Tabish Bidiwale
aedf4a34af
docs(release): add 0.1.0 notes
2025-09-06 21:01:19 +10:00
Tabish Bidiwale
f0c52ac7e8
Merge pull request #54 from Fission-AI/changeset-release/main
...
chore(release): version packages
2025-09-06 14:56:28 +10:00
github-actions[bot]
f933e9b144
Version Packages
2025-09-06 04:43:55 +00:00
Tabish Bidiwale
24b4866426
chore(changeset): seed release notes
2025-09-06 14:35:50 +10:00
Tabish Bidiwale
b7899602b4
chore(ci): add release workflows
2025-09-06 14:32:32 +10:00
Tabish Bidiwale
b66d914198
chore(changesets): add config and script
2025-09-06 02:52:02 +10:00
Tabish Bidiwale
9926103505
chore(pkg): scope to @fission-ai and set public
2025-09-06 02:34:11 +10:00
Tabish Bidiwale
873e45a996
Merge pull request #53 from Fission-AI/prepare-publish
...
build: prepare for package publish
2025-09-06 02:28:48 +10:00
Tabish Bidiwale
573afa0c65
prepare for package publish
2025-09-06 02:22:38 +10:00
Tabish Bidiwale
665d740adb
Remove retrospective doc
2025-09-01 11:34:23 +10:00
Tabish Bidiwale
c35dd38567
Test cursor rules
2025-08-27 21:20:37 +10:00
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
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
Tabish Bidiwale
a79b8b5c03
Merge pull request #47 from Fission-AI/fix-invalid-spec-files
...
fix: fix invalid files
2025-08-20 01:42:09 +10:00
Tabish Bidiwale
52d620e40e
fix invalid files
2025-08-20 01:41:36 +10:00
Tabish Bidiwale
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
Tabish Bidiwale
6458b6ed39
feat: adopt verb-noun CLI structure
2025-08-20 01:01:17 +10:00
Tabish Bidiwale
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