Skip to main content
bkit-rules Core rules for bkit โ PDCA methodology, level detection, agent triggering, quality standards, Sprint management (8-phase container with 4 auto-pause triggers, v2.1.13), and Trust Level scope (L0-L4 gates PDCA + Sprint auto-run).
Triggers: bkit rules, core rules, methodology
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/popup-studio-ai/bkit-claude-code --skill bkit-rulesThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository bkend.ai authentication โ email/social login, JWT tokens, RBAC, session management.
Triggers: bkend auth, bkend login, bkend signup, bkend JWT, bkend RBAC
bkend.ai project tutorials (todo to SaaS) and common error troubleshooting.
Triggers: bkend tutorial, bkend cookbook, bkend troubleshooting
bkend.ai database โ CRUD, column types, filtering, sorting, relations, indexing.
Triggers: bkend table, bkend CRUD, bkend column, bkend relation, bkend data
name bkit-rules classification workflow classification-reason Process automation persists regardless of model advancement deprecation-risk none effort low description Core rules for bkit โ PDCA methodology, level detection, agent triggering, quality standards, Sprint management (8-phase container with 4 auto-pause triggers, v2.1.13), and Trust Level scope (L0-L4 gates PDCA + Sprint auto-run).
Triggers: bkit rules, core rules, methodology
user-invocable false allowed-tools ["Read","Glob","Grep"]
bkit Core Rules
Automatically applied rules that don't require user commands.
1. PDCA Auto-Apply Rules
No Guessing : If unsure, check docs โ If not in docs, ask user
SoR Priority : Code > CLAUDE.md > docs/ design documents
Request Type Claude Behavior New feature Check docs/02-design/ โ Design first if missing Bug fix Compare code + design โ Fix Refactoring Current analysis โ Plan โ Update design โ Execute Implementation complete Suggest Gap analysis
Template References
Document Type Template Path Plan ${CLAUDE_PLUGIN_ROOT}/templates/plan.template.mdDesign ${CLAUDE_PLUGIN_ROOT}/templates/design.template.mdAnalysis ${CLAUDE_PLUGIN_ROOT}/templates/analysis.template.mdReport ${CLAUDE_PLUGIN_ROOT}/templates/report.template.md
2. Level Auto-Detection
Detection Order
Check CLAUDE.md for explicit Level declaration
File structure based detection
Enterprise (2+ conditions met)
infra/terraform/ folder
infra/k8s/ or kubernetes/ folder
services/ folder (2+ services)
turbo.json or pnpm-workspace.yaml
docker-compose.yml
.github/workflows/ (CI/CD)
Dynamic (1+ conditions met)
bkend settings in .mcp.json
lib/bkend/ or src/lib/bkend/
supabase/ folder
firebase.json
Starter
None of the above conditions met.
Level-specific Behavior
Aspect Starter Dynamic Enterprise Explanation Friendly, avoid jargon Technical but clear Concise, use terms
Code comments Detailed Core logic only Architecture only
Error handling Step-by-step guide Technical solutions Brief cause + fix
PDCA docs Simple Feature-specific Detailed architecture
Primary Agent starter-guidebkend-expertenterprise-expert
Reference Skill starterdynamicenterprise
Level Upgrade Signals
Starter โ Dynamic: "Add login", "Save data", "Admin page"
Dynamic โ Enterprise: "High traffic", "Microservices", "Own server"
Hierarchical CLAUDE.md Rules project/
โโโ CLAUDE.md # Project-wide (always reference)
โโโ services/CLAUDE.md # Backend work context
โโโ frontend/CLAUDE.md # Frontend work context
โโโ infra/CLAUDE.md # Infrastructure context
Rule: Area-specific rules > Project-wide rules
3. Agent Auto-Trigger Rules
Level-Based Selection When user requests feature development:
Detect project level
Invoke appropriate agent automatically
Task-Based Selection User Intent Auto-Invoke Agent "code review", "security scan" bkit:code-analyzer"design review", "spec check" bkit:design-validator"gap analysis" bkit:gap-detector"report", "summary" bkit:report-generator"QA", "log analysis" bkit:qa-monitor"pipeline", "which phase" bkit:pipeline-guide
Proactive Suggestions After completing major tasks, suggest relevant agents.
Do NOT Auto-Invoke When
User explicitly declines
Task is trivial
User wants to understand process
Agent already invoked for same task
4. Code Quality Standards
Pre-coding Checks
Does similar functionality exist? Search first
Check utils/, hooks/, components/ui/
Reuse if exists; create if not
Core Principles DRY : Extract to common function on 2nd use
SRP : One function, one responsibility
No Hardcoding : Use meaningful constants
Extensibility : Write in generalized patterns
Self-Check After Coding
Same logic exists elsewhere?
Can function be reused?
Hardcoded values present?
Function does only one thing?
When to Refactor
Same code appears 2nd time
Function exceeds 20 lines
if-else nests 3+ levels
Same parameters passed to multiple functions
5. Task Classification Classify tasks to apply appropriate PDCA level:
Classification Content Size PDCA Level Action Quick Fix < 50 chars None Execute immediately Minor Change 50-200 chars Lite Show summary, proceed Feature 200-1000 chars Standard Check/create design doc Major Feature > 1000 chars Strict Require design, user confirmation
Classification Keywords Quick Fix : fix, typo, correct, adjust, tweak
Minor Change : improve, refactor, enhance, optimize, update
Feature : add, create, implement, build, new feature
Major Feature : redesign, migrate, architecture, overhaul, rewrite
6. Output Style Auto-Selection (v1.5.1) When project level is detected, automatically suggest the matching output style:
Level Suggested Style Trigger Condition Starter bkit-learningLevel detected as Starter Dynamic bkit-pdca-guideLevel detected as Dynamic Enterprise bkit-enterpriseLevel detected as Enterprise
Auto-Selection Rules
On session start: Suggest output style matching detected level
On /starter init, /dynamic init, /enterprise init: Auto-suggest style for that level
On PDCA phase transitions: Suggest bkit-pdca-guide if not already active
User can override with /output-style at any time
Available Output Styles Style Best For Key Features bkit-learningBeginners, learning Learning points, TODO(learner) markers, concept explanations bkit-pdca-guidePDCA workflows Status badges, checklists, phase progress, gap analysis suggestions bkit-enterpriseArchitecture decisions Tradeoff analysis, cost impact, deployment strategy, SOLID compliance
7. Agent Teams Auto-Suggestion (v1.5.1) Suggest Agent Teams when conditions are met:
Suggestion Triggers Condition Suggestion Major Feature (>= 1000 chars) AND Dynamic/Enterprise level "Agent Teams can parallelize PDCA phases. Try /pdca team {feature}" Match Rate < 70% AND Dynamic/Enterprise level "Consider Agent Teams for faster parallel Check-Act iteration" Enterprise project init "Your project supports 4-teammate Agent Teams mode" Dynamic project init "Your project supports 2-teammate Agent Teams mode"
Team Availability Level Available Teammates Roles Starter No - - Dynamic Yes 2 developer, qa Enterprise Yes 4 architect, developer, qa, reviewer
Requirements
Environment: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
If env var not set: Suggest setting it when team mode would be beneficial
Command: /pdca team {feature} to start team mode
8. Agent Memory Awareness (v1.5.1) Agent Memory is automatically active for all bkit agents. No user action required.
How It Works
Agents remember project context across sessions via memory: project scope
Some agents (starter-guide, pipeline-guide) use memory: user for cross-project learning
Memory persists in .claude/agent-memory/ (project) or ~/.claude/agent-memory/ (user)
Memory Scopes Scope Agents Using Persistence project9 agents (code-analyzer, gap-detector, pdca-iterator, etc.) Per-project, across sessions user2 agents (starter-guide, pipeline-guide) Global, across all projects
Proactive Mention
On session start: "Agent Memory is active โ agents remember context across sessions"
When agent is invoked: Agent may reference previous session context
No configuration needed โ fully automatic
9. Plugin Hot Reload (v1.6.0) After modifying bkit plugin files, use /reload-plugins to apply changes without restarting Claude Code.
No need to exit and re-enter the session
Changes to skills, agents, hooks, and templates are reflected immediately
Note: Changes to CLAUDE.md require /clear to fully refresh
Wildcard Permissions (CC 2.1.0+) CC 2.1.0+ supports Bash(pattern*) wildcard permissions.
bkit Recommended Patterns
Bash(npm *) - Allow all npm commandsBash(git log*) - Allow git log variantsBash(node *) - Allow node executionBash(npx *) - Allow npx execution
Deny Recommendations
Bash(rm -rf*) - Deny recursive delete (dangerous)Bash(git push --force*) - Deny force push
Configuration Add to .claude/settings.json:
{
"permissions" : {
"allow" : [ "Bash(npm *)" , "Bash(git log*)" ] ,
"deny" : [ "Bash(rm -rf*)" ]
}
}
