- Install Claude Code as described here
- Pay for some Anthropic LLM tokens (Start with $20.00 worth)
- Install OpenSpec as described here
- Clone the repo of your choice
- Open the repo in your IDE of choice
- Review this advice from Gemini
- Open a terminal window and type: claude
- Then type /init
- Close the window runnning Claude (so it can see the claude commands created in the next step)
- Open a terminal window and type: openspec init
- Review the instructions at the bottom of the init results
- Open a 2nd terminal window and type claude
- In claude, type: Please read openspec/project.md and help me fill it out with details about my project, tech stack, and conventions
- Review the resulting openspec/project.md file
- In Claude, type: Explain the OpenSpec workflow from openspec/AGENTS.md and how I should work with you on this project
- You are now ready to propose your first change to the code base. In Claude, type: I want to add [YOUR FEATURE HERE]. Create an OpenSpec change proposal for this feature
- Review the resulting .md files
- To review the outstanding items, in the OpenSpec terminal window type: openspec list
- To validate the proposed changes, in Claude type: validate the proposal
- To implement the proposed changes, in Claude type: implment the proposal to do it all at once, or implement section 1 if you want to work incrementally
Last active
January 24, 2026 20:53
-
-
Save pambrose/c9d29521dfdebaf2bbc7bd1d14d710f7 to your computer and use it in GitHub Desktop.
Brownfield OpenSpec and Claude Code Usage
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment