envelope

Solid

Classify any incoming directive as Ship / Ask one focused question / Propose first. Forces a sharp decision instead of a multi-option survey to the principal. The default failure mode for agents is treating ship-work as ask-work (over-surveying) or treating propose-work as ship-work (rushing irreversible changes). This skill prevents both.

AI & Automation 11 stars 3 forks Updated today MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
36
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Envelope Sort an incoming request into one of three envelopes — **A: Ship**, **B: Ask one focused question**, **C: Propose first** — and act accordingly. ## When to use - The principal gives a directive and you're tempted to respond with multiple clarifying questions - The work involves a fork in the road and you're tempted to present multiple options - Before posting any "should I…?" question - Triggered by Caddy on prompts like: "should I", "before I start", "is this clear", "is this OK", "couple options", "two paths", "ambiguous", "not sure if you want", "want me to", "ship vs ask", "decision tree", "fork in the road" ## The decision tree (run top-to-bottom) ``` 1. Is the request unambiguous? YES → step 2 NO → can I resolve the ambiguity by reading code/data/docs? YES → resolve, then step 2 NO → ENVELOPE B: ask exactly one focused question with options spelled out 2. Is the change reversible? YES → step 3 NO → is the irreversibility expensive? (data loss, schema migration, deploy, broken contract) YES → ENVELOPE C: propose first, wait for sign-off NO → step 3 3. Is the change bounded to a known surface area? YES → step 4 NO → can I re-scope to a bounded version? YES → propose the bounded version + ship that NO → ENVELOPE C: propose first 4. Do I have full context to make the change correctly? YES → ENVELOPE A: SHIP NO → load missing context (search/read/query); re-evaluate 5. Af...

Details

Author
wrg32786
Repository
wrg32786/aigent-os
Created
1 months ago
Last Updated
today
Language
JavaScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

ask-the-council

Convenes a panel of opinionated advisors (parallel Claude subagents, each with a distinct mandate and a forbidden move so they genuinely diverge), then a Chairman synthesis that COMMITS to one recommendation with explicit tradeoffs. Use proactively for any high-stakes design, architecture, or tradeoff decision where credible options genuinely compete. Also on "ask the council", "the council", "get a panel". Not for fact-finding or decisions with one obvious answer — answer those directly.

6 Updated 2 days ago
alonbaron
Code & Development Listed

ship

Carry a change to the veld repo from empty diff to merged PR the way this project expects — autonomous implementation, adversarial review rounds, draft PR, wait for green CI, and (when authorized) bypass-merge. Opens with a short kickoff questionnaire that sets review depth and merge policy for the rest of the run. Use when the maintainer says "ship this", "build and merge X", "implement and open a PR", "take this to merge", or hands over a feature/fix to carry all the way to main. Not for one-off edits with no PR.

12 Updated today
prosperity-solutions
AI & Automation Listed

instinct

Load before any non-trivial engineering action: writing new code, changing existing code or its behavior, choosing between designs, adding or updating a dependency, or deleting/replacing an abstraction. Establishes whether this is the right change and the smallest correct version of it before implementation starts. Skip for pure information questions with no code change, and for requests where the user has already specified the exact change and is asking only for its execution.

0 Updated today
bhouvana