User Tools

Site Tools


tips:openspec

**This is an old revision of the document!**

OpenSpec

install

yay -S openspec

add openspec to existing project

cd <project>

openspec init

from agent auto compile openspec\project.md with command

Please read openspec/project.md and help me fill out with details about my project, tech stack, and conventions.

it is possible to change openspec tools with “openspec init” and “openspec update”

add new feature

Proposal

1) create proposal

# kilocode
/openspec-proposal.md load multiple svm models
 
# other agents
/openspec:proposal load multiple svm models

file created

openspec/changes/
└── load-multiple-svm-models
    ├── proposal.md
    ├── specs
    │   └── svm-anomaly-detection
    │       └── spec.md
    └── tasks.md

Proposal Structure:

  • proposal.md: Explains why multiple models are needed (flexibility for different scenarios), what changes will be made, and the impact
  • tasks.md: Detailed implementation checklist broken into 5 phases (design, configuration, processor modification, main function updates, and testing)
  • spec.md: Specification deltas with both MODIFIED (existing SVM loading requirement) and ADDED (new model configuration requirement) sections, including proper scenarios

2) Review proposal.md and rebuild spec.md and tasks.md

update acceptance criteria for this proposal

3) Review spec.md and tasks.md

eventually check status of proposals

openspec view
openspec list    # Confirm the change folder exists
openspec validate load-multiple-svm-models
openspec show load-multiple-svm-models   # Review proposal, tasks, and spec delta

Apply

coding

# kilocode
/openspec-apply.md load-multiple-svm-models
 
# other agents
/openspec:apply load-multiple-svm-models

…testing…

Update tasks list

All tasks for the change [your-change-name] are finished. Please update the tasks.md

Archive

After implementation and testing, archive the change. All of the checkboxes in the TODO list were checked, and files were moved to the archive folder.

#openspec archive load-multiple-svm-models --yes
openspec archive load-multiple-svm-models --skip-specs --yes
tips/openspec.1762594497.txt.gz · Last modified: by sscipioni