About charted-green
A testing skill that activates implemented TODO tests one at a time and makes only the changes needed to pass each test. It also updates specified design-document progress markers and stops when the tests are green.
Key features
- 01Uses the design document as source of truth
- 02Activates implemented tests one at a time
- 03Makes only test-related implementation changes
- 04Updates specified progress checkboxes
- 05Runs tests after each change
Use cases
- 01Progressively implement a test file's TODO tests
- 02Keep implementation scoped to the current test
- 03Track completed work in a design document
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ marmicode/ skills --skill charted-greenAfter installing, type/charted-greenin Claude Code to confirm it loaded.
Details
From the project READMEContext
- designDocPath: $ARGUMENTS[0]
- testFilePath: $ARGUMENTS[1]
Goal
Using the design doc at ${designDocPath} as the single source of truth, progressively activate the tests in ${testFilePath}.
Steps
- Categorize each test in
${testFilePath}as:
- Implemented tests: tests that contain actual test code (not just empty or comments)
- Empty tests: tests that are empty or only contain comments - TOTALLY IGNORE THESE
- For each implemented test, convert
it.todo(...)intoit(...), but do it strictly one test at a time, then update the implementation just enough for that specific test to turn green — NOTHING MORE.
DO NOT IMPLEMENT ANYTHING THAT IS NOT DIRECTLY RELATED TO THE CURRENT TEST.
-
After the current test passes, update progress in
${designDocPath}(see Design Doc Progress below). -
STOP when these tests are green.
-
Remove the wiprecation (@deprecated 🚧 work in progress) jsdoc from the implementated item if it is done and safe to use.
Design Doc Progress
After each test turns green, update ${designDocPath} to reflect completed work.
Flip 🚧 to ✅ and - [ ] to - [x]. Do not edit any other text, headings, diagrams, or structure in the design doc.
Check off items in these sections only:
- PR's Testing Strategy — the
### 🚧 {test_title}heading that matches the test you just activated. - PR's Tasks — every
- [ ] ...taslk description...item whose work is now done and verified by the passing test. - PR Plan — the
## 🚧 {pr_title}entry when all PR's Tasks and Testing Strategy items are checked off.
If you are unsure whether an Implementation Details item is done, leave it unchecked.
Rules
DO NOT IMPLEMENT EMPTY TESTS.
NEVER implement tests.
ONLY EDIT TESTS as a last resort after you have tried everything else.
Design doc edits are only checkbox-based or 🚧 to ✅ replacements. Never reword, reorder, add, or remove content in ${designDocPath}.
Run tests after each change. Only once the current test passes should you advance to the next one.
Use the Wallaby Skill if available to run tests, otherwise run tests using the recommended approach for the project.