Agent skills · AI SDLC

One shared brain for all your repos.

A cited map of how your repos fit together. One command from ticket to linked PRs in every repo.

$npx skills add oct8-studio/kbee
Works with
Claude CodeCodexCursorGitHub CopilotGemini CLI

    
Why kbee

Your system isn't one repo. Your agent thinks it is.

Agent alone

  • Sees one repo, forgets between sessions
  • Changes the API, breaks the web app
  • Opens one PR and misses the rest

Agent + kbee

  • Starts with the map of every repo
  • Checks every consumer before shipping
  • Opens linked PRs, in merge order
How it works

One command. It asks you three things.

A ticket, a Figma link or a sentence in. Linked PRs out.

  1. 01Spec

    Repos and contracts affected

    “Is this what we're building?”
  2. 02Plan

    Tasks per repo, in order

    “Good to build?”
  3. 03Build

    Test-first, on branches

  4. 04Review

    Every consumer checked

  5. 05Ship

    Linked PRs, merge order

    “Open these PRs?”
  6. 06Sync

    KB stays true

Stop any time. It resumes where it left off. First run? It sets up the KB first.
Built to stay accurate

No citation, no fact.

  • Every fact cites repo, commit and lines
  • Citations reread before writing
  • Knows which facts went stale
  • Never edits facts silently
  • Says “I don't know” instead of guessing
kb /contracts/orders.md

POST /orders/:id/cancel sets the order to cancelled, and returns 409 when the order is already paid.

Consumed by shop-web, which shows “Paid orders can't be cancelled” on a 409.

Click a citation ↓

shop-api · src/orders.ts✓ reread at a1b2c3d, lines match
40export async function cancelOrder(id: string) {41  const order = await db.orders.find(id);42  if (order.status === 'paid') {43    throw new Conflict('paid orders cannot be cancelled');44  }45  order.status = 'cancelled';46  await events.emit('order.cancelled', order);47  return db.orders.save(order);48}
The knowledge base

Plain Markdown, in git.

No server, no account. Ask it anything with /kbee ask.

shop/
  kb/                  # lives inside the repo
    system-map.md      # packages, ownership, links
    repos/<package>/   # overview + conventions
    contracts/         # producer → consumers
    decisions/         # architecture decisions
    features/<slug>/   # spec, plan, status, review
    gaps.md            # open questions
    manifest.json
  packages/api/
  packages/web/
  packages/types/
  • Docs merge with the codeSame branch, same PR.
  • One PR per monorepo featureStill planned per package.
  • The default/kbee init asks, inside is preselected.
Already have docs?

Keep them. kbee checks them.

/kbee audit adopts docs in any format.

  1. Findkb/, docs/, ADRs, AGENTS.md, READMEs
  2. Check against the codeGaps, wrong claims, missing sources
  3. Fix, after one yesRewrite, or keep yours and add alongside

Never touches your files unless you choose the rewrite.

› /kbee audit
  found kb/  hand-written · 41 pages · no manifest
  also  AGENTS.md, docs/adr/ (6)

◆ coverage 7 of 9 packages · 23 of 26 routes
           missing  packages/billing, packages/search
◆ accuracy ✗ 3 claims don't match the code
           orders.md: 404 on paid orders, code: 409
◆ sources  58 claims have no file reference
◆ kbee     needs manifest.json, contracts/, gaps.md

  ? Rewrite into kbee's layout, or keep yours
    and add kbee's structure alongside?  keep mine
  ✓ kb/ adopted · ready for /kbee build
Your tools

Uses the tools your agent already has.

JiraMCP

Reads the ticket. Posts PR links back, after a yes.

FigmaMCP

Builds from the frames. Checks the UI against them.

GitHubgh CLI

Opens linked PRs. Reads issues as input.

Not connected? Paste the ticket text instead.

Commands

You only need /kbee.

It picks the right skill for you.

Needs git and a coding agent. Sized for ~10 repos of ~100k lines.

/kbee build <ticket | link | text>Ticket to linked PRs
/kbee initSet up or join a KB
/kbee auditAdopt existing docs
/kbee ask "…"Cited answers
/kbee syncKeep the KB true
/kbeeStatus
Under the hood: 11 skills
kbeeThe one command; routes to the rest
kbee-initSet up a KB, or join your team's existing one
kbee-auditFind, check and adopt an existing KB
kbee-featureRun every stage below, start to finish
kbee-specSpec, with the affected repos and contracts
kbee-planTasks per repo, producers before consumers
kbee-implementTest-first on kbee/<slug> branches
kbee-reviewCorrectness and contract checks against consumers
kbee-shipPush and open cross-linked PRs, after one yes
kbee-syncKeep the KB true, including after merges
kbee-kbAsk, expand, add a repo, or fix the KB

Give your agents the whole picture.

Install, then /kbee build your next ticket.

$npx skills add oct8-studio/kbee