One constitution for every project
Keep your principles in a Git repository. Each project keeps an exact copy, and Caramelo offers to sync when the repository changes.
caramelo.constitution.repositorySkip to contentApprove the spec
VS Code extension · Compatible with GitHub Spec Kit
Approve the spec
before the AI writes the code.
Caramelo puts Spec Kit’s workflow in a sidebar. Requirements, design and tasks are generated by the model you choose, and each one waits for your approval before the next.
ext install fsilvaortiz.carameloFree and open source (MIT) · VS Code 1.95 or later
One phase at a time
Each step writes a file you can read, edit and commit. Approving one unlocks the next; regenerating one marks the steps after it as out of date.
- Constitution
constitution.mdThe principles every generation has to follow. Write them, generate them from a description, or sync them from your organization’s repository.
- Requirements
spec.mdUser stories and testable requirements from a one-line brief. Clarify asks up to five questions where the brief is ambiguous.
- Design
plan.mdThe technical plan, with research.md, data-model.md and contracts/ next to it.
- Tasks
tasks.mdNumbered tasks in dependency order. Tasks marked [P] can run in parallel.
- Implement
your codeRun one task or all of them. The agent reads your codebase and edits files; every write and shell command waits for your approval.
- Converge
tasks.mdCompares the code with the spec and the plan, and appends the work that is still missing. Existing tasks are never rewritten.
Use the model you already pay for, or one on your laptop
Set up several providers and switch between them with a click, even halfway through a spec. Custom auth headers work behind corporate gateways.
- GitHub Copilot
- Claude
- OpenAI
- Gemini
- Groq
- Ollama
- LM Studio
- Any OpenAI-compatible endpoint
Works the way your team already does
Spec Kit hooks run on their own
Hooks run before and after each step, with the same conditions Spec Kit evaluates. Turn each one on or off from the sidebar.
.specify/extensions.ymlSame files as the Spec Kit CLI
Caramelo reads and writes the same folders and templates, synced from Spec Kit releases. Switch between the two whenever you want.
specs/001-password-reset/Specs from Jira issues
Pick a Jira Cloud issue and its title and description become the brief for the requirements.
Create Spec from JiraNothing changes without you
- Every file write and shell command asks for approval first.
- The agent can only read and write inside your workspace.
- Untrusted workspaces never run the agent, hooks or Git.
- API keys stay in VS Code’s secret storage and are redacted from logs.