agentleFS
popup-studio-aipopup-studio-ai/bkit-claude-code/skills/control/SKILL.md

control

Skill605 starsChanged 3 months agoApache-2.0View on GitHub

Control bkit automation level (L0-L4), view trust score, and manage guardrails. Trust level directly drives SPRINT_AUTORUN_SCOPE (v2.1.13): L0 manual+stopAfter=prd, L4 full-auto+stopAfter=archived. Also gates PDCA phase transitions and destructive operations. Triggers: control, automation level, trust score, guardrail

8 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

11 rules. 0 are common, 3 are distinctive, and 8 are very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 8

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read runtime control state from .bkit/runtime/control-state.json

    line 56
  2. Very specific:

    Read trust score from .bkit/state/trust-score.json

    line 57
  3. Very specific:

    Read active guardrails from lib/control/ configuration

    line 58
  4. Very specific:

    Read current level from .bkit/runtime/control-state.json

    line 87
  5. Distinctive:

    If escalating (going higher), warn user about reduced oversight

    line 88
  6. Distinctive:

    If de-escalating, apply immediately without confirmation

    line 89
  7. Very specific:

    Update .bkit/runtime/control-state.json with new level

    line 90
  8. Very specific:

    Write audit log entry via lib/audit/audit-logger.js

    line 91
  9. Very specific:

    Write audit log: automation_paused

    line 113
  10. Very specific:

    Read previousLevel from .bkit/runtime/control-state.json

    line 120
  11. Distinctive:

    If not paused, display: "Automation is not paused."

    line 121

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Control Skill

User-invocable skill for managing bkit automation level and system status.

Arguments

ArgumentDescriptionExample
(none)Show current status (same as status)/control
statusShow automation level, trust score, guardrails/control status
level <0-4>Set automation level manually/control level 2
pausePause all automation (equivalent to L0)/control pause
resumeResume to previous automation level/control resume
trustShow trust score details and history/control trust

Automation Levels

LevelNameDescriptionApproval Gates
L0ManualAll actions require explicit user approvalEvery phase transition
L1GuidedSuggestions provided, user confirms each stepEvery phase transition
L2Semi-AutoRoutine transitions auto, key decisions gateddo->check, check->report, report->archive
L3AutoMost transitions auto, only destructive ops gatedreport->archive
L4Full-AutoFully automated PDCA cycle, minimal interventionInitial feature approval only

Action Details

status (Default)

Display the current automation control state.

  1. Read runtime control state from .bkit/runtime/control-state.json
  2. Read trust score from .bkit/state/trust-score.json
  3. Read active guardrails from lib/control/ configuration
  4. Display formatted status panel

Output Format:

--- bkit Control Panel ----------------------------
Automation Level : L2 (Semi-Auto)
Trust Score      : 72/100
Active Guardrails: 8/8
Paused           : No
Features Active  : 2/3
---------------------------------------------------
Guardrails:
  [ON] Destructive operation detection
  [ON] Blast radius limiter (max 10 files)
  [ON] Loop breaker (max 5 iterations)
  [ON] Checkpoint auto-creation
  [ON] Permission escalation gate
  [ON] Stale feature timeout (7d)
  [ON] Context overflow protection
  [ON] Concurrent write lock
---------------------------------------------------

level <0-4>

Set the automation level manually.

  1. Validate input is a number 0-4
  2. Read current level from .bkit/runtime/control-state.json
  3. If escalating (going higher), warn user about reduced oversight
  4. If de-escalating, apply immediately without confirmation
  5. Update .bkit/runtime/control-state.json with new level
  6. Write audit log entry via lib/audit/audit-logger.js
  7. Display confirmation with new level details

Escalation Rule: Level increases require explicit confirmation via AskUserQuestion. Level decreases are immediate (safe direction).

Level Mapping to Automation:

LevelautomationLevelDescription
L0manualAll manual
L1guideGuided suggestions
L2semi-autoSemi-automatic (default)
L3autoMostly automatic
L4full-autoFully automatic

pause

Pause all automation immediately.

  1. Save current level to .bkit/runtime/control-state.json as previousLevel
  2. Set level to L0 (Manual)
  3. Set paused: true flag
  4. Write audit log: automation_paused
  5. Display confirmation: "Automation paused. All operations require manual approval."

resume

Resume automation to the previous level before pause.

  1. Read previousLevel from .bkit/runtime/control-state.json
  2. If not paused, display: "Automation is not paused."
  3. Restore level to previousLevel
  4. Clear paused flag
  5. Write audit log: automation_resumed
  6. Display confirmation with restored level

trust

Show trust score details and contributing factors.

  1. Read trust score from .bkit/state/trust-score.json
  2. Calculate score breakdown:
    • PDCA completion rate (0-25 points)
    • Match rate average (0-25 points)
    • Error recovery rate (0-20 points)
    • Session stability (0-15 points)
    • User override frequency (0-15 points, inverse)
  3. Display detailed breakdown

Output Format:

--- Trust Score Details ---------------------------
Overall Score: 72/100

Breakdown:
  PDCA Completion Rate  : 18/25  (72% cycles completed)
  Match Rate Average    : 22/25  (88% average)
  Error Recovery Rate   : 14/20  (70% recovered)
  Session Stability     : 12/15  (80% stable)
  User Override Freq    :  6/15  (40% override rate)
---------------------------------------------------
Level Recommendation: L2 (Semi-Auto)
  Score 0-30  -> L0 (Manual)
  Score 31-50 -> L1 (Guided)
  Score 51-70 -> L2 (Semi-Auto)
  Score 71-85 -> L3 (Auto)
  Score 86+   -> L4 (Full-Auto)
---------------------------------------------------

State Files

FilePurpose
.bkit/runtime/control-state.jsonRuntime control state (level, paused, previousLevel)
.bkit/state/trust-score.jsonTrust score and contributing metrics

Module Dependencies

ModuleFunctionUsage
lib/control/automation-controller.jsgetLevel(), setLevel()Read/write automation level
lib/control/automation-controller.jspause(), resume()Pause/resume automation
lib/audit/audit-logger.jswriteAuditLog()Record control changes

Usage Examples

# Check current status
/control

# Set to Semi-Auto
/control level 2

# Pause all automation
/control pause

# Resume previous level
/control resume

# View trust score
/control trust

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.