kobserve

Launch executor sessions, verify milestone PRs, and land merges for signed specs.

2|1|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/kpiteira/devops-ai --skill kobserve-kpiteira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kobserve
Source: https://github.com/kpiteira/devops-ai/tree/main/skills/kobserve
Command: npx skills add https://github.com/kpiteira/devops-ai --skill kobserve-kpiteira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating the human–planner–executor contract in an AI-assisted development workflow requires a dedicated observer seat that launches executor sessions for milestones, independently verifies delivered milestone PRs before merge, and tears down infrastructure after landing — without ever deciding product semantics or merging code itself. ## Core Features & Use Cases - Launch: Provision a git worktree, executor session, and Docker sandbox in one step via kinfra impl, then kick off the executor with the milestone brief and environment facts. - Verify: Independently re-run the brief's blocking tests against the PR head, run the contract-integrity guard, gate every "For the human" item with the human before merge, and push the spec bookkeeping commit onto the PR branch. - Land: Confirm the spec's Decomposition row landed with the merge, tear down the worktree, sandbox slot, and session with kinfra done, and launch newly unblocked dependent milestones. - Use Case: After a planner signs a feature spec with three milestones, use this seat to launch each executor session, verify each milestone PR's blocking tests and verdict report before the human merges, and land each merge with full teardown. ## Quick Start Ask the assistant to run /kobserve launch reminders/M1 to start an executor session for the first milestone of a signed feature spec.

Frequently Asked Questions about kobserve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I launch an executor session for a milestone?

Run kinfra impl <feature>/M<N> --session --group <project> to create the worktree, session, and sandbox in one step. Always pass an explicit group, since sessions without one inherit the parent's group and may queue behind its running-session cap.

How do I verify a milestone PR before merging?

Independently re-run the brief's blocking command against the PR head, run the contract-integrity guard, and put every "For the human" item to the human before merge. Quote the babysit report's newest Verdict line verbatim and never upgrade a non-merge-ready verdict.

Can the observer seat request Copilot reviews or relay fix dispositions?

No. The observer seat never requests reviews, never runs kreview, and never relays dispositions to executors. Its only review-loop moves are sending /kbabysit <n> to the executor or asking the human a question.

What happens if sandbox provisioning fails during launch?

The slot stays allocated and kinfra sandbox start retries the sandbox, but no session is created. Once the sandbox is up, create the session manually with agent-deck add, agent-deck session start, and send the /kbuild kickoff yourself.

How does spec bookkeeping land when main requires pull requests?

Push the Decomposition row and fact-correction amendments as one commit onto the milestone PR branch from a detached worktree, so the merge carries them. If nothing is open to ride on, create a dedicated bookkeeping branch and PR against main.

What are the limitations of the kobserve observer seat?

It never merges PRs, never decides product semantics, and never edits briefs or acceptance tests, which belong to planner branches only. It also cannot change a babysit verdict in chat; verdicts change only when the loop appends a new report section.