adopt
Skill2 starsChanged 5 days agoMITView on GitHub
Bring existing code under greenlight by writing rules and examples that describe what it already does, with tests that pass today and locks that keep them honest. Use when the user runs /greenlight:adopt "<area of the code>", or asks to add tests and specs to code that already exists before changing it.
27 other projects use a version of this.
Adopted by
Most recently taken up by
- maideps/ai-harness-frameworktheir own version, first seen Nov 8, 2026
- striderZA/OpenCodeGameStudiostheir own version, first seen Nov 4, 2026
- myowinthein/claude-helmtheir own version, first seen Nov 1, 2026
- dcbruck/claude-skillstheir own version, first seen Oct 20, 2026
- HurricaHjz/SecondSelftheir own version, first seen Oct 20, 2026
- Donchitos/Claude-Code-Game-Studiostheir own version, first seen Oct 19, 2026
Used with
Projects with it also use create-stories, story-done and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
lilangMaxSkillcreate-stories
Break a single epic into implementable story files. Reads the epic, its GDD, governing ADRs, and control manifest. Each story embeds its GDD requirement TR-ID, ADR guidance, acceptance criteria, story type, and test evidence path. Run after /create-epics for each epic.
Also in 11 projects that use this
lilangMaxSkillstory-done
End-of-story completion review. Reads the story file, verifies each acceptance criterion against the implementation, checks for GDD/ADR deviations, prompts code review, updates story status to Complete, and surfaces the next ready story from the sprint.
Also in 11 projects that use this
- +10 more from lilangMax
Other versions27 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 27
- Donchitos/Claude-Code-Game-Studios★ 27ksame name
- HurricaHjz/SecondSelf★ 156same name
- striderZA/OpenCodeGameStudios★ 118same name
- HurricaHjz/second-yourself★ 105same name
- cenconq25/claude-code-app-studio★ 40same name
- mrveiss/AutoBot-AI★ 39same name
- dawn840705/codex-code-studios★ 17same name
- lilangMax/ClaudeCodeGameStudios★ 8same name
- hongyuanc/codex-game-studios★ 5same name
- codebycorey/delta-spec★ 4same name
17 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 1 is distinctive, and 2 are very specific to this project.
0
Common
Most of the 25 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 29
If the person actually wants the behaviour to change, say so and offer /greenlight:feature instead.
- Very specific: line 36
Follow the loop of the feature skill phase by phase with these differences (details in phases/adopt.md):
- Distinctive: line 45
Verify with the spec-auditor as usual.
“Common” is measured: kept by at least 6 in 10 of the 25 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
greenlight adopt (the orchestrator for existing code)
You run in the main session, exactly as the feature skill does: you drive the phases, you talk to the person, and you
are the only one who records anything. The phase agents cannot ask the person and report instead of recording. Read
${CLAUDE_PLUGIN_ROOT}/skills/feature/SKILL.md for the loop, the rules for questions, change requests, costs and
assumptions, and the human gates; they all apply. Then read ${CLAUDE_PLUGIN_ROOT}/phases/adopt.md: it lists what is
different, and it is the plan.
Arguments: $ARGUMENTS
What an adoption is
A normal feature goes red, then green, with new code in between. An adoption describes behaviour the system already
has: every scenario is tagged @existing, the tests pass from the start, and no production code is written or
changed. Its value is the safety net: afterwards a change to that area goes through /greenlight:feature or
/greenlight:change with locked, traced tests behind it.
Before anything
- The project must be set up (
.bdd/config.tomlexists); if not, tell the person to run/greenlight:initand stop. - The arguments must name an area of the code that can be described in a handful of rules. If it is vague or large, look at the repository read-only, propose slices, and ask which one to start with. One slice per adoption.
- If the person actually wants the behaviour to change, say so and offer
/greenlight:featureinstead. - Settle the autonomy level once, as the
featureskill does. - The working tree should be committed or at least understood: the bind gate pins the production source as it is then.
Run it
bdd state next-id, thenbdd state init FEAT-n --title "<area>" --adopt --autonomy LEVEL.- Follow the loop of the
featureskill phase by phase with these differences (details inphases/adopt.md):- Tell every agent in its task: this is an adoption, describe existing behaviour, tag every scenario
@existing, change no production code, cite where each rule was observed. - Code that looks wrong is a question for the person, never a rule and never a fix.
- At bind: lock the bound files, then
bdd gate FEAT-n bind --result pass --record-red(the run is a valid red because every scenario is@existingand passes). tasksandimplementhave no agent. Pass tasks with--detail adopt=true. For implement runbdd run FEAT-n,bdd classify FEAT-n --expect greenandbdd adopt FEAT-n --checkyourself, thenbdd gate FEAT-n implement --result pass --detail adopt=true. Never start the implementer.- Verify with the spec-auditor as usual.
- Tell every agent in its task: this is an adoption, describe existing behaviour, tag every scenario
- The person types
/greenlight:approve FEAT-n rulesand/greenlight:approve FEAT-n examples. You never do.
Never
- Edit a production file, a feature file, a step or a driver yourself, or let an agent edit production code. The gates
implementandverifyrefuse an adoption whose production source changed since the bind gate. - Turn a failing scenario into a passing one by changing the code. Fix the scenario (the reading was wrong) or ask the person.
- Present an adoption as a change of behaviour, or the reverse.
When it is done
Show the report's verdict, bdd trace FEAT-n, the enforcement level, the assumptions, the cost per phase, any code
that looked wrong (as questions the person may want to turn into a feature), and the next slice if there was one. Then
stop; do not start the next adoption on your own.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

