Example

CLI Maintenance

The happy path for bounded implementation with one authorized capability and clear stop points.

Persona	cli-maintainer
Directive	bounded-cli-fix
Kits	cli-maintenance-guardrails
Authorized Skills	code-editing
Forbidden Skills	autonomous-agent-loop, deployment-runner

Adopt This Root

Copy the closest example root into your project.
Rename the copied folder to .personakit.
Revise the session, persona, directive, kits, and skills for your lane.
Run personakit validate before relying on the root.
Inspect the resolved contract before exporting handoff context.

Inspect The Contract Pieces

Start with the session file; it shows which persona, directive, kits, and skills compose this lane.

Session Sessions/cli-maintenance.session.json Persona Packs/personas/cli-maintainer.persona.json Directive Packs/directives/bounded-cli-fix.directive.json Kit Packs/kits/cli-maintenance-guardrails.kit.json Authorized Skill Packs/skills/code-editing.skill.json Forbidden Skill Packs/skills/deployment-runner.skill.json

This example is the happy path for a bounded PersonaKit implementation lane. It shows how code editing can be authorized while deployment and autonomous loops are forbidden.

Use this when a practical coding task repeats often enough that the same role, stop points, and verification should be visible every time.

Prompt This Replaces

Fix this small CLI bug. Be careful, do not deploy anything, do not start a long-running agent loop, and show me what would happen before you run it.

PersonaKit keeps that repeated caution out of the task prompt and puts it in the session contract where it can be inspected.

Key Contract Signal

authorizedSkillIds: code-editing

Runnable Commands

cd Site/public/examples/swift-cli-maintenance
personakit validate --root personakit-root
personakit contract --root personakit-root --session cli-maintenance
personakit export --root personakit-root --session cli-maintenance

Expected Validation Shape

Validation summary: personas=1 kits=1 directives=1 intents=0 references=0 skills=3 essentials=1 errors=0

What To Inspect

The session resolves to cli-maintainer and bounded-cli-fix.
code-editing is authorized for this session.
deployment-runner and autonomous-agent-loop are forbidden.
The export output is inspectable before any coding tool starts work.
The directive stops before arbitrary command execution, persistence, or orchestration.

Why This Is Better Than A Prompt Snippet

A prompt snippet can say “be careful.” This contract says who the agent is acting as, what kind of work this is, which capability is authorized, which skills are forbidden, and when review is mandatory.

The prompt can stay small because the durable boundary now lives in PersonaKit.