Skip to content
Back to search

bees-agentic-template

🐝 One hive, every agent β€” a reusable, team-shareable agentic dev environment for Claude Code, Copilot, Cursor & Codex.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/nciross/bees-agentic-template with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/nciross/bees-agentic-template'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nciross--bees-agentic-template/badge.svg)](/listings/nciross--bees-agentic-template)

HTML

<a href="/listings/nciross--bees-agentic-template"><img src="/api/listings/nciross--bees-agentic-template/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires **Node.js 22+**. Your project can be in any language.

Option A: any tool, with the CLI

cd your-existing-project
npx github:nciross/bees-agentic-template init   # pick tools + packs interactively
git status                                      # review what bees generated
git add -A && git commit -m "chore: add bees agentic dev environment"

Prefer a permanent `bees` command? `npm install -g github:nciross/bees-agentic-template`. Every install option (global, dev dependency, from source, CI) is in **[docs/install.md](docs/install.md)**.

> [!WARNING] > The npm package is `bees-agentic`, not `bees` (that name belongs to an unrelated package). Never run `npx bees`.

Option B: Claude Code only, as a plugin marketplace

> Coming with the plugin marketplace milestone (see the [roadmap](#-roadmap)).

/plugin marketplace add nciross/bees-agentic-template
/plugin install bees-security@bees

Everyday commands

| Command | What it does | |---|---| | `bees init` | Detect stack, choose tools & packs, write `bees.yaml`, generate configs | | `bees sync` | Re-generate configs (idempotent, preserves your edits) | | `bees sync --check` | Fail if configs are stale β€” use it in CI | | `bees add <pack>` / `bees remove <pack>` | Enable or disable a pack | | `bees list` | List available packs | | `bees doctor` | Diagnose drift and broken markers | | `bees update` | Bump pinned upstream versions *(coming with upstream packs)* |

Test it on your project first

Not ready to touch your repo? Run bees against a disposable copy and get a checklist of what works:

git clone https://github.com/nciross/bees-agentic-template && cd bees-agentic-template && npm install
npm run test:real -- ../your-project            # or a git URL

Your project is never modified. See **[docs/testing.md](docs/testing.md)** for the unit, end-to-end and real-project test suites.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 257 lines
  1. <div align="center">
  2. <img src="assets/logo.svg" alt="bees logo: a cute robot bee waving from a honeycomb" width="200">
  3. # bees
  4. <h3>One hive, every agent.</h3>
  5. **A reusable, team-shareable agentic dev environment β€” install it into any existing project and every teammate gets the same skills, agents, rules and guardrails, whatever AI tool they use.**
  6. [![CI](https://github.com/nciross/bees-agentic-template/actions/workflows/ci.yml/badge.svg)](https://github.com/nciross/bees-agentic-template/actions/workflows/ci.yml)
  7. [![npm](https://img.shields.io/npm/v/bees-agentic?label=npm&color=cb3837)](https://www.npmjs.com/package/bees-agentic)
  8. [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
  9. [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](#-contributing)
  10. [![Status: early preview](https://img.shields.io/badge/status-early%20preview-orange.svg)](#-roadmap)
  11. ![Claude Code](https://img.shields.io/badge/Claude%20Code-supported-d97757)
  12. ![GitHub Copilot](https://img.shields.io/badge/Copilot-supported-24292f)
  13. ![Cursor](https://img.shields.io/badge/Cursor-supported-000000)
  14. ![Codex](https://img.shields.io/badge/Codex-supported-10a37f)
  15. [Why bees](#-why-bees) Β· [How it works](#-how-it-works) Β· [Packs](#-packs) Β· [Memory](#-elephant---goldfish--memory-that-scales) Β· [The hive](#-meet-the-hive) Β· [Quick start](#-quick-start) Β· [Team sharing](#-share-it-with-your-team) Β· [Roadmap](#-roadmap)
  16. </div>
  17. > [!NOTE]
  18. > **bees is in early preview.** The CLI (`init`, `sync`, `add`, `remove`, `doctor`) and the `core` pack work today for all four tools; the other packs land pull request by pull request β€” see the [roadmap](#-roadmap).
  19. ---
  20. ## 🍯 Why bees?
  21. Every developer on a team ends up hand-tuning their own AI setup: a different `CLAUDE.md`, a few copied Cursor rules, a half-maintained Copilot prompt folder. The result is a **swarm without a hive** β€” inconsistent code, duplicated effort, and security rules that only some agents follow.
  22. **bees** fixes that:
  23. - 🏠 **One source of truth** β€” skills, agents, commands, rules and hooks are written once, as portable [Agent Skills](https://agentskills.io) (`SKILL.md`) plus a small `pack.yaml`.
  24. - πŸ”Œ **Drop-in for existing projects** β€” `bees init` detects your stack and wires everything in. No rewrite, no new framework.
  25. - 🀝 **Every tool, same behaviour** β€” native configs are generated for **Claude Code, GitHub Copilot, Cursor and Codex**, plus a shared `AGENTS.md`.
  26. - πŸ‘₯ **Team-shareable by default** β€” commit `bees.yaml`; teammates are prompted to install the same setup automatically.
  27. - πŸ“Œ **Upstream, pinned** β€” best-in-class community packs (Impeccable, GitHub Spec Kit, security skills) are installed from their official sources at pinned versions β€” never copied, never drifting.
  28. - ♻️ **Safe re-syncs** β€” bees only touches content between `<!-- bees:begin -->` / `<!-- bees:end -->` markers. Your own edits are preserved.
  29. ## 🧭 How it works
  30. ```mermaid
  31. flowchart LR
  32. subgraph Hive["🐝 bees (this repo)"]
  33. P1[core]:::pack
  34. P2[design]:::pack
  35. P3[spec]:::pack
  36. P4[security]:::pack
  37. P5[quality Β· testing Β· git-flow Β· docs]:::pack
  38. end
  39. CFG["bees.yaml<br/>(committed in your project)"] --> CLI
  40. Hive --> CLI(("bees CLI<br/>init Β· sync Β· doctor"))
  41. CLI --> A1["Claude Code<br/>.claude/ Β· CLAUDE.md"]
  42. CLI --> A2["Copilot<br/>.github/copilot-instructions.md<br/>.github/prompts/"]
  43. CLI --> A3["Cursor<br/>.cursor/rules/*.mdc"]
  44. CLI --> A4["Codex<br/>AGENTS.md Β· skills"]
  45. CLI --> UP["Upstream installers<br/>Impeccable Β· Spec Kit"]
  46. classDef pack fill:#ffd43b,stroke:#e8a400,color:#1a1a1a
  47. ```
  48. 1. **Packs** live in this repo: each one is a folder of `SKILL.md` skills, agents, commands, rules and hooks, described by a `pack.yaml`.
  49. 2. **Your project** declares which tools and packs it wants in `bees.yaml`.
  50. 3. **The bees CLI** renders every pack through a per-tool **adapter** and calls official upstream installers for third-party packs.
  51. 4. **CI** runs `bees sync --check` so generated configs never go stale.
  52. ## 🧩 Packs
  53. | Pack | What you get | Source |
  54. |---|---|---|
  55. | 🐝 **core** | Shared `AGENTS.md` conventions, project-context skill, sane permissions | bees |
  56. | 🎨 **design** | Frontend design fluency, anti-generic-UI guidance, design-token rules | [Impeccable](https://github.com/pbakaus/impeccable) (pinned) + bees glue |
  57. | πŸ“ **spec** | Spec-driven development: constitution β†’ spec β†’ plan β†’ tasks β†’ implement | [GitHub Spec Kit](https://github.com/github/spec-kit) (pinned) + bees glue |
  58. | πŸ›‘οΈ **security** | Secure-coding & threat-model (STRIDE) skills, dependency audit, secret-blocking hook, `/security-review` | bees + optional pinned upstream security skills |
  59. | βœ… **quality** | Code-review agent, `/review` command, lint/format after every edit | bees |
  60. | πŸ§ͺ **testing** | Test-writer agent, TDD workflow skill | bees |
  61. | 🌿 **git-flow** | GitHub flow commands: branch β†’ conventional commit β†’ PR | bees |
  62. | πŸ“š **docs** | README, ADR and changelog skills | bees |
  63. | 🐘🐟 **memory** | Elephant (long-term team memory in git) + Goldfish (short-term session memory, summarized then forgotten) | bees |
  64. | πŸ‘₯ **team** | A named crew of agents β€” tech lead, architect, developer, designer, reviewer, security, QA, writer, token optimizer | bees |
  65. ### Supported tools
  66. | | Claude Code | GitHub Copilot | Cursor | Codex |
  67. |---|:-:|:-:|:-:|:-:|
  68. | Shared rules (`AGENTS.md`) | βœ… | βœ… | βœ… | βœ… |
  69. | Skills (`SKILL.md`) | βœ… | βœ… | βœ… | βœ… |
  70. | Commands / prompts | βœ… | βœ… | βœ… | βœ… |
  71. | Sub-agents | βœ… | βœ… | βž– | βž– |
  72. | Hooks (guardrails) | βœ… | βž– | βœ… | βž– |
  73. | Plugin marketplace | βœ… | βž– | βž– | βž– |
  74. <sub>βœ… native Β· βž– not available in the tool; bees falls back to rules in `AGENTS.md`.</sub>
  75. ## 🐘 Elephant & 🐟 Goldfish β€” memory that scales
  76. Agents forget everything between sessions β€” or remember too much and burn tokens. bees splits memory in two:
  77. | | 🐘 **Elephant** β€” never forgets | 🐟 **Goldfish** β€” forgets on purpose |
  78. |---|---|---|
  79. | **What** | Decisions, conventions, lessons learned, glossary | What happened in *this* session |
  80. | **Where** | `.bees/memory/` β€” committed, reviewed, shared with the whole team | `.bees/goldfish/` β€” gitignored, local |
  81. | **Lifetime** | Forever (until compacted) | One session β†’ a short handoff note |
  82. | **Token cost** | Only a tiny index is always loaded; entries are pulled on demand | Near zero β€” summarized, then dropped |
  83. A goldfish note that keeps coming back gets **promoted** to elephant memory through a normal pull request β€” so knowledge grows with review, not by accident.
  84. ## πŸ‘₯ Meet the hive
  85. bees ships a crew of specialised agents. Each has a name and a role, and writes issues, reviews and PR comments **like a human teammate would** β€” clear, friendly, to the point.
  86. | | Agent | Role | Typical work |
  87. |---|---|---|---|
  88. | πŸ‘‘ | **Maya** | Tech Lead | Breaks work into tasks, routes them to the right agent, final go/no-go |
  89. | πŸ›οΈ | **Omar** | Architect | System design, ADRs, trade-off analysis |
  90. | πŸ› οΈ | **Sam** | Developer | Implements features test-first |
  91. | 🎨 | **Lina** | Designer | UI/UX with Impeccable, design tokens, accessibility |
  92. | πŸ” | **Kenji** | Reviewer | Code review with actionable, kind comments |
  93. | πŸ›‘οΈ | **Aisha** | Security Engineer | Threat models, secure-coding review, dependency audit |
  94. | πŸ§ͺ | **Leo** | QA Engineer | Test plans, edge cases, regression checks |
  95. | ✍️ | **Nora** | Writer | Issues, PR descriptions, docs, changelogs |
  96. | πŸͺ™ | **Theo** | Token Optimizer | Context budgets, model routing, memory compaction |
  97. Rename them, drop some, or add your own in `bees.yaml`.
  98. > [!NOTE]
  99. > **Humans stay in control.** Agents *draft* issues and comments into `.bees/drafts/`; nothing is posted to GitHub until a human approves. Every post ends with a small signature β€” `β€” Maya, Tech Lead Β· bees agent 🐝` β€” so readers always know an agent wrote it.
  100. ## πŸš€ Quick start
  101. Requires **Node.js 22+**. Your project can be in any language.
  102. ### Option A: any tool, with the CLI
  103. ```bash
  104. cd your-existing-project
  105. npx github:nciross/bees-agentic-template init # pick tools + packs interactively
  106. git status # review what bees generated
  107. git add -A && git commit -m "chore: add bees agentic dev environment"
  108. ```
  109. Prefer a permanent `bees` command? `npm install -g github:nciross/bees-agentic-template`. Every install option (global, dev dependency, from source, CI) is in **[docs/install.md](docs/install.md)**.
  110. > [!WARNING]
  111. > The npm package is `bees-agentic`, not `bees` (that name belongs to an unrelated package). Never run `npx bees`.
  112. ### Option B: Claude Code only, as a plugin marketplace
  113. > Coming with the plugin marketplace milestone (see the [roadmap](#-roadmap)).
  114. ```text
  115. /plugin marketplace add nciross/bees-agentic-template
  116. /plugin install bees-security@bees
  117. ```
  118. ### Everyday commands
  119. | Command | What it does |
  120. |---|---|
  121. | `bees init` | Detect stack, choose tools & packs, write `bees.yaml`, generate configs |
  122. | `bees sync` | Re-generate configs (idempotent, preserves your edits) |
  123. | `bees sync --check` | Fail if configs are stale β€” use it in CI |
  124. | `bees add <pack>` / `bees remove <pack>` | Enable or disable a pack |
  125. | `bees list` | List available packs |
  126. | `bees doctor` | Diagnose drift and broken markers |
  127. | `bees update` | Bump pinned upstream versions *(coming with upstream packs)* |
  128. ### Test it on your project first
  129. Not ready to touch your repo? Run bees against a disposable copy and get a checklist of what works:
  130. ```bash
  131. git clone https://github.com/nciross/bees-agentic-template && cd bees-agentic-template && npm install
  132. npm run test:real -- ../your-project # or a git URL
  133. ```
  134. Your project is never modified. See **[docs/testing.md](docs/testing.md)** for the unit, end-to-end and real-project test suites.
  135. ## βš™οΈ Configuration
  136. The full target format is shown below; today only the `core` pack ships, and `team` / `overrides` are reserved for upcoming packs.
  137. ```yaml
  138. # bees.yaml β€” committed to your project
  139. version: 1
  140. tools: [claude, copilot, cursor, codex]
  141. packs:
  142. - core
  143. - design # Impeccable, pinned
  144. - spec # GitHub Spec Kit, pinned
  145. - security
  146. - quality
  147. - testing
  148. - git-flow
  149. - docs
  150. - memory # 🐘 elephant + 🐟 goldfish
  151. - team
  152. team:
  153. tech-lead: { name: Maya }
  154. designer: { name: Lina }
  155. writer: { name: Nora, post: draft } # draft β†’ human approves β†’ gh posts
  156. token-optimizer:
  157. name: Theo
  158. budgets: { agents-md: 2000, skill: 1500 } # tokens
  159. overrides:
  160. security:
  161. block-paths: [".env*", "secrets/**"]
  162. ```
  163. ## πŸ‘₯ Share it with your team
  164. 1. One person runs `bees init` and opens a PR.
  165. 2. The PR adds `bees.yaml`, `bees.lock` and the generated configs.
  166. 3. After merge, every teammate gets the same setup in whichever tool they use β€” Claude Code users are even prompted to install the bees plugins automatically via the committed `.claude/settings.json`.
  167. 4. Need something project-specific? Write it **outside** the bees markers β€” `bees sync` will never overwrite it.
  168. ## πŸ“ Roadmap
  169. - [x] Repository, README & MIT license
  170. - [x] Repo hygiene: contributing guide, security policy, templates, CI
  171. - [x] ADR 0001: install scopes (user Β· project Β· local)
  172. - [x] Pack format, `core` pack, `AGENTS.md` generation
  173. - [x] CLI core: `init`, `sync`, `--check`, `add`, `remove`, `doctor`
  174. - [x] Adapters: Claude Code, Copilot, Cursor, Codex
  175. - [x] Tests: unit, end-to-end fixtures, real-project runner
  176. - [ ] Pack JSON schemas, user/local scopes (ADR 0001), Claude Code plugin marketplace
  177. - [ ] Packs: design (Impeccable), spec (Spec Kit), security
  178. - [ ] Packs: quality, testing, git-flow, docs
  179. - [ ] Pack: memory β€” 🐘 elephant & 🐟 goldfish
  180. - [ ] Pack: team β€” named agents, draft β†’ approve β†’ post workflow
  181. - [ ] **v0.1.0** release on npm as `bees-agentic`
  182. ## 🀝 Contributing
  183. bees uses **[GitHub flow](https://docs.github.com/en/get-started/using-github/github-flow)**:
  184. 1. Branch from `main` (`feat/…`, `fix/…`, `docs/…`, `chore/…`).
  185. 2. Commit using [Conventional Commits](https://www.conventionalcommits.org/).
  186. 3. Open a pull request β€” CI must pass before merge.
  187. 4. `main` is always releasable.
  188. New pack ideas are very welcome β€” open a [new pack proposal](https://github.com/nciross/bees-agentic-template/issues/new?template=new_pack.yml). See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide and [docs/adr/](docs/adr/) for architecture decisions.
  189. ## πŸ™ Credits
  190. bees stands on the shoulders of great open-source work: [Impeccable](https://github.com/pbakaus/impeccable), [GitHub Spec Kit](https://github.com/github/spec-kit), and the [Agent Skills](https://agentskills.io) open standard. Third-party packs are installed from their upstream sources and remain under their own licenses.
  191. ## πŸ“„ License
  192. [MIT](LICENSE) Β© 2026 nciross
  193. <div align="center"><sub>Built by humans and their agents, buzzing together. 🐝</sub></div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.