{"id":47740589,"url":"https://github.com/helderberto/tracerkit","last_synced_at":"2026-04-09T11:15:49.206Z","repository":{"id":348372619,"uuid":"1197432289","full_name":"helderberto/tracerkit","owner":"helderberto","description":"Spec-driven development workflow for AI agents - PRD, plan, check.","archived":false,"fork":false,"pushed_at":"2026-04-02T16:59:53.000Z","size":12168,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T08:32:35.344Z","etag":null,"topics":["ai","claude-code","context-engineering","engineering","prd","sdd","sdlc","spec-driven-development","spec-planning","specification","tracerkit"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/helderberto.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-31T15:19:24.000Z","updated_at":"2026-04-02T16:59:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/helderberto/tracerkit","commit_stats":null,"previous_names":["helderberto/tracerkit"],"tags_count":47,"template":false,"template_full_name":null,"purl":"pkg:github/helderberto/tracerkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helderberto%2Ftracerkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helderberto%2Ftracerkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helderberto%2Ftracerkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helderberto%2Ftracerkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helderberto","download_url":"https://codeload.github.com/helderberto/tracerkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helderberto%2Ftracerkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31382355,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T23:20:52.058Z","status":"ssl_error","status_checked_at":"2026-04-03T23:20:51.675Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude-code","context-engineering","engineering","prd","sdd","sdlc","spec-driven-development","spec-planning","specification","tracerkit"],"created_at":"2026-04-02T23:43:04.796Z","updated_at":"2026-04-05T01:01:33.125Z","avatar_url":"https://github.com/helderberto.png","language":"TypeScript","readme":"\u003cimg src=\"./tracerkit.png?c=2\" alt=\"TracerKit\" width=\"100%\" /\u003e\n\n\u003cbr /\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![CI](https://github.com/helderberto/tracerkit/actions/workflows/ci.yml/badge.svg)](https://github.com/helderberto/tracerkit/actions/workflows/ci.yml)\n[![npm version](https://img.shields.io/npm/v/tracerkit)](https://www.npmjs.com/package/tracerkit)\n[![npm downloads](https://img.shields.io/npm/dm/tracerkit)](https://www.npmjs.com/package/tracerkit)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nReplace ad-hoc AI prompts with a repeatable spec-driven workflow: from idea to verified, archived spec.\n\nNamed after the tracer-bullet technique from _The Pragmatic Programmer_: **Tracer** + **Kit**.\n\n**Markdown skills, zero runtime deps.** No build step, no project dependencies.\n\n\u003c/div\u003e\n\n## Why TracerKit?\n\nAI assistants work best with small, well-scoped tasks — not sprawling layers or flat task lists. TracerKit structures every feature as **tracer-bullet vertical slices**: each phase cuts through every layer (schema → service → API → UI → tests) and is demoable on its own. Integration problems surface early, not at the end.\n\nThe workflow is three skills: **define** (`/tk:prd`), **plan** (`/tk:plan`), **verify** (`/tk:check`). Skills are pure Markdown with zero runtime deps — the AI reads your specs directly, counts progress, and archives completed work. No build step, no CLI at runtime.\n\n## Get Started\n\n### Install\n\n```bash\n$ npm install -g tracerkit\n$ tracerkit init\n```\n\nSkills are installed to `~/.claude/skills/`, available in every project. Safe to re-run — adds missing skills without overwriting ones you've modified.\n\n### Workflow\n\n```\nYou: /tk:prd add dark mode support\nAI:  Written .tracerkit/prds/dark-mode-support.md\n     Run `/tk:plan dark-mode-support` next?\n\nYou: /tk:plan dark-mode-support\nAI:  Phase 1 — Theme visible end-to-end\n     Phase 2 — User can toggle and persist preference\n     Written .tracerkit/plans/dark-mode-support.md\n     Run `/tk:check dark-mode-support` when ready?\n\nYou: # open the plan, implement each phase, write tests...\n\nYou: /tk:check dark-mode-support\nAI:  Status: done | Total: 5/5\n     Archived to .tracerkit/archives/dark-mode-support/\n```\n\nUse `/tk:brief` at the start of any session to see active features and pick up where you left off:\n\n```\nYou: /tk:brief\nAI:  | Feature           | Status      | Age | Progress | Next                         |\n     |-------------------|-------------|-----|----------|------------------------------|\n     | dark-mode-support | in_progress | 3d  | 3/7      | Toggle component renders ... |\n\n     **Focus → dark-mode-support**\n```\n\nSee [Examples](docs/examples.md) for full walkthroughs.\n\n\u003cdetails\u003e\n\u003csummary\u003ePer-project usage\u003c/summary\u003e\n\nTo scope skills to a single project (team members get them via git):\n\n```bash\n$ tracerkit init .              # install to .claude/skills/ in current dir\n$ tracerkit update .            # update project-scoped skills\n$ tracerkit uninstall .         # remove project-scoped skills\n```\n\n\u003c/details\u003e\n\n## Skills\n\nTracerKit ships skills that take a feature from idea to verified archive.\n\n### `/tk:prd \u003cidea\u003e`: Write a PRD\n\nInteractive interview that explores your codebase, asks scoping questions one at a time, designs deep modules, and writes a structured PRD.\n\n**Output:** `.tracerkit/prds/\u003cslug\u003e.md`\n\n### `/tk:plan \u003cslug\u003e`: Create an implementation plan\n\nReads a PRD and breaks it into phased **tracer-bullet vertical slices**. Each phase is a thin but complete path through every layer (schema, service, API, UI, tests), demoable on its own.\n\n**Output:** `.tracerkit/plans/\u003cslug\u003e.md`\n\n### `/tk:brief`: Session briefing\n\nShows active features, their progress, and suggested focus. Use at the start of a session to orient.\n\n**Output:** Feature dashboard in the terminal — no files written.\n\n### `/tk:check [slug]`: Verify and archive\n\nVerifies the codebase against the plan's done-when checkboxes. Runs tests, validates user stories, updates phase progress, and transitions the PRD status. On `done`, archives the PRD and plan to `.tracerkit/archives/\u003cslug\u003e/` automatically.\n\nWithout arguments, shows a feature dashboard with status and progress before asking which feature to check.\n\n**Output:** Verdict block in `.tracerkit/plans/\u003cslug\u003e.md`. On `done`: `.tracerkit/archives/\u003cslug\u003e/prd.md` + `.tracerkit/archives/\u003cslug\u003e/plan.md`\n\n## Docs\n\n| Document                                         | Description                                        |\n| ------------------------------------------------ | -------------------------------------------------- |\n| [Examples](docs/examples.md)                     | Walk through end-to-end usage scenarios            |\n| [CLI Reference](docs/cli-reference.md)           | Lifecycle commands: init, update, uninstall        |\n| [Configuration](docs/configuration.md)           | Configure custom artifact paths via `config.json`  |\n| [Metadata Lifecycle](docs/metadata-lifecycle.md) | Understand YAML frontmatter states and transitions |\n| [Comparison](docs/comparison.md)                 | Compare TracerKit to Spec Kit, Kiro, and OpenSpec  |\n\n## Contributing\n\n1. Fork the repo and create a feature branch\n2. Use TracerKit itself to plan your change (`/tk:prd` + `/tk:plan`)\n3. Implement following the plan phases\n4. `npm run lint:fix \u0026\u0026 npm run test:run \u0026\u0026 npm run typecheck`\n5. [Conventional Commits](https://www.conventionalcommits.org/) (enforced by commitlint)\n6. Open a PR against `main`\n\n## Support\n\nFor support, please [open a GitHub issue](https://github.com/helderberto/tracerkit/issues). We welcome bug reports, feature requests, and questions.\n\n## Acknowledgments\n\nThis project was born out of [Claude Code for Real Engineers](https://www.aihero.dev/cohorts/claude-code-for-real-engineers-2026-04), a cohort by [Matt Pocock](https://github.com/mattpocock). The hands-on approach to building real things with Claude Code sparked the idea for TracerKit. If you're serious about AI-assisted engineering, I can't recommend Matt's cohorts and content highly enough.\n\n## License\n\n[MIT License](LICENSE) © [helderberto](https://helderberto.com)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelderberto%2Ftracerkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelderberto%2Ftracerkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelderberto%2Ftracerkit/lists"}