{"id":50817185,"url":"https://github.com/broneq/bdk","last_synced_at":"2026-06-13T10:33:11.138Z","repository":{"id":351018027,"uuid":"1208439364","full_name":"broneq/bdk","owner":"broneq","description":"BDK — Broneq Dev Kit. Reusable Claude Code workflows: skills, agents, and hooks for TDD, planning, code review, and architecture documentation.","archived":false,"fork":false,"pushed_at":"2026-05-08T10:51:33.000Z","size":821,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-08T12:34:49.875Z","etag":null,"topics":["ai-agents","claude-code","claude-code-plugin","claude-code-plugins","claude-code-skill","claude-code-skills","claude-workflows","code-review","developer-tools","tdd","workflows"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/broneq.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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-04-12T09:30:04.000Z","updated_at":"2026-05-08T10:51:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/broneq/bdk","commit_stats":null,"previous_names":["broneq/bdk"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/broneq/bdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broneq%2Fbdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broneq%2Fbdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broneq%2Fbdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broneq%2Fbdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/broneq","download_url":"https://codeload.github.com/broneq/bdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/broneq%2Fbdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34281700,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-agents","claude-code","claude-code-plugin","claude-code-plugins","claude-code-skill","claude-code-skills","claude-workflows","code-review","developer-tools","tdd","workflows"],"created_at":"2026-06-13T10:33:10.367Z","updated_at":"2026-06-13T10:33:11.104Z","avatar_url":"https://github.com/broneq.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BDK — Broneq Dev Kit\n\nA personal Claude Code plugin packaging reusable dev workflows, skills, agents, and hooks into a single installable unit.\n\n**Core design principle**: Language-agnostic by default. Skills contain workflow logic only; environment discovery is delegated to `STARTUP_INSTRUCTIONS.md` and the local project's `CLAUDE.md`.\n\n---\n\n## Installation\n\n**From GitHub directly (recommended until marketplace listing is live):**\n\n1. Add the BDK marketplace source:\n   ```\n   /plugin marketplace add broneq/bdk\n   ```\n2. Install:\n   ```\n   /plugin install bdk@bdk\n   ```\n\n---\n\n## Skills\n\nInvoke with `/bdk:\u003cskill-name\u003e`:\n\n| Skill | Description                                                                                         |\n|-------|-----------------------------------------------------------------------------------------------------|\n| `/bdk:setup` | Initialize `.bdk/settings.json` — run once per project before using other skills                    |\n| `/bdk:cr` | Dynamic code review (3-13 parallel agents based on change size)                                     |\n| `/bdk:commit` | Generate conventional commit message from git changes                                               |\n| `/bdk:create-plan` | Create TDD-driven implementation plans                                                              |\n| `/bdk:execute-plan` | Execute a plan with task tracking and verification                                                  |\n| `/bdk:subagent-execute-plan` | Execute a plan task-by-task with a fresh implementer subagent per task and a single end-of-branch review |\n| `/bdk:verify-plan` | Verify a plan against real code before execution                                                    |\n| `/bdk:debug` | Structured debugging: investigate → failing tests → fix or plan                                     |\n| `/bdk:refactor` | Propose object-oriented architecture for complex code                                               |\n| `/bdk:test-driven-development` | Rigid TDD cycle: red → green                                                                        |\n| `/bdk:brainstorming` | Design sessions before implementation                                                               |\n| `/bdk:create-adr` | Generate Architecture Decision Records (MADR format)                                                |\n| `/bdk:save-progress` | Checkpoint in-progress work to `.bdk/save-progress/`                                                |\n| `/bdk:restore-progress` | Resume work from a saved checkpoint                                                                 |\n| `/bdk:explain-complex-code` | Generate architecture docs with Graphviz diagrams                                                   |\n| `/bdk:update-docs` | Refresh existing architecture docs after code changes                                               |\n| `/bdk:graphviz-docs-compiler` | Compile `.dot` files to SVG and update markdown references                                          |\n| `/bdk:graph-review` | Risk-aware code review using knowledge graph — change detection, impact analysis, test coverage     |\n| `/bdk:graph-explore` | Navigate codebase structure using knowledge graph — stats, architecture, call relationships         |\n| `/bdk:graph-debug` | Debug issues using graph-powered code navigation — trace call chains, correlate with recent changes |\n| `/bdk:graph-refactor` | Safe refactoring using dependency analysis — dead code, rename preview, impact verification         |\n\n---\n\n## Agents\n\nUsed by skills internally (invoke via `subagent_type`):\n\n| Agent | Model | Purpose |\n|-------|-------|---------|\n| `code-reviewer` | sonnet | Layer-group deep code review |\n| `implementer` | sonnet | End-to-end task implementation (TDD, lint, commit) — used by `/bdk:subagent-execute-plan` |\n| `fixer` | sonnet | Apply specific findings (review, lint, test failures) — used by `/bdk:subagent-execute-plan` |\n| `explorer` | haiku | Fast codebase exploration (CodeGraph → Serena → Grep) |\n| `test-runner` | haiku | Run tests, parse and report results |\n| `dead-code-detector` | haiku | Find unreachable/unused code |\n| `duplicate-detector` | haiku | Find code duplication |\n| `architecture-reviewer` | opus | Audit against architectural rules |\n| `static-analyse` | haiku | Detect and run project lint/format/type-check |\n| `step-simulator` | opus | Dry-run plans with concrete data traces |\n| `log-analyzer` | haiku | Parse and summarize error logs |\n| `web-researcher` | haiku | Search web for solutions and docs |\n\n---\n\n## Quality Rules\n\nBDK ships language-agnostic rule sets (`code-quality`, `architecture`) injected into `/bdk:cr` and `/bdk:create-plan` outputs.\n\n### Four usage patterns\n\n**1. Zero config (recommended for most projects).** No settings entry. BDK defaults are used as-is.\n\n**2. Extend defaults.** Point `.bdk/settings.json` at a file with project-specific additions:\n\n```json\n{\n  \"quality\": {\n    \"code-quality\": \"docs/standards/coding.md\"\n  }\n}\n```\n\nThe BDK default content is emitted first, then your file's content appended.\n\n**3. Replace defaults.** When your project has its own complete rule set:\n\n```json\n{\n  \"quality\": {\n    \"code-quality\": {\n      \"path\": \"docs/standards/coding.md\",\n      \"mode\": \"replace\"\n    }\n  }\n}\n```\n\n**4. Point at existing project doc.** Same as pattern 2, but the path can be any existing standards doc — no copy needed.\n\n### Behaviour on misconfiguration\n\nIf `.bdk/settings.json` references a file that doesn't exist (or is unreadable), `inject-rules.py` exits 1 with a clear error. `/bdk:cr` and `/bdk:create-plan` will surface the error and stop, rather than silently dropping the rule context.\n\n### Adding a new rule category\n\nSee `.claude/rules/quality-rules.md` (BDK-dev convention).\n\n---\n\n## What Does NOT Go Into BDK\n\nThese stay in the project-level `.claude/` of each repo:\n\n- **Rules** — project-specific domain rules (architecture layers, domain logic, etc.)\n- **Plans** — generated per-project\n- **Project-specific hooks** — drift detection, worktree setup, directory creation\n- **Domain skills** — feature-specific workflows\n- **Language-specific hooks** — Python formatters, Go linters tied to one stack\n\n---\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, authoring conventions, and how to add skills/agents.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbroneq%2Fbdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbroneq%2Fbdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbroneq%2Fbdk/lists"}