本文へ移動
cccskills
無料GitHub で公開

mission-statement

Define and develop plugin mission statements — purpose, values, anti-patterns, and trade-offs. Use when creating a new plugin, auditing an existing plugin's alignment, or providing a reference for the alignment check loop to evaluate decisions against. Produces mission.json with [draft] status and writes an interview file for the human to refine it.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md7.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

If the user's intent does not match this skill, route through /plugin-creator:plugin-lifecycle.

<invocation_args>$ARGUMENTS</invocation_args>

Mission Statement

What It Is (and Isn't)

A plugin mission statement is a decision-making anchor, not a feature description. It states what the plugin values, what it refuses to do, and how it resolves trade-offs — enabling AI agents to evaluate alignment without asking the human each time.

Mission Statement IsMission Statement Is Not
A decision-making anchorA feature list or capability overview
An explicit anti-pattern registryA marketing or sales description
A trade-off resolution guideA roadmap or version history
A verifiable alignment referenceA technical specification

The mission.json Format

The file lives at the plugin root (not in .claude/plan/).

{
  "status": "draft",
  "mission": "One sentence. What this plugin is trying to be — not what it does.",
  "values": [
    "Value statement 1 — concrete, verifiable",
    "Value statement 2"
  ],
  "anti_patterns": [
    "Specific behavior this plugin refuses to do",
    "Another explicit refusal"
  ],
  "escalation_triggers": [
    "keyword", "another keyword phrase"
  ],
  "trade_offs": {
    "correctness_vs_speed": "correctness",
    "breadth_vs_depth": "depth",
    "explicit_vs_implicit": "explicit"
  },
  "out_of_scope": [
    "Thing that looks related but belongs elsewhere"
  ],
  "interview_backlog_item": "#NNN",
  "validated_scenarios": []
}

Field definitions:

  • status — "draft" until interview completes and human approves; then "active"
  • mission — single sentence; must pass the "bad twin" test (a bad version of this plugin could not claim the same statement)
  • values — observable principles that guide decisions; must be verifiable against behavior
  • anti_patterns — explicit refusals; what this plugin will not do even when asked
  • escalation_triggers — keyword list for fast string-match in alignment checks; no LLM needed
  • trade_offs — when forced to choose, which side does this plugin take
  • out_of_scope — things that look adjacent but belong in other plugins
  • interview_backlog_item — GitHub issue number of the interview task (added after backlog creation)
  • validated_scenarios — list of known past decisions that this statement correctly predicts

Development Process

Three phases:

  1. AI Draft (immediate, this session) — source: discussion context + plugin files. Output: mission.json with status: "draft". The [draft] tag signals this is a hypothesis, not a decision.
  2. Interview (async, via backlog task) — five structured questions asked to the human. Raw answers captured in backlog item. Output: updated mission.json with human-verified values.
  3. Validation (after interview) — run 3 known past decisions through the statement. Does it predict the right choice? Output: validated_scenarios populated; status: "active".

The Five Interview Questions

These questions surface actual values, not stated ones. Ask them in order.

Q1 — The Non-Negotiable

"What is the one thing this plugin must never sacrifice, even to ship faster?"

Anchors values[0] — the primary principle.

Q2 — The Bad Twin

"What would a superficially similar but wrong version of this plugin do? What makes it wrong?"

Populates anti_patterns. A good mission statement the bad twin cannot also claim.

Q3 — The Trade-off

"When forced to choose between [breadth vs depth / correctness vs speed / explicit vs implicit], which does this plugin choose, and why?"

Ask all three. If the human says "both" — ask "if you could only have one." Answers populate trade_offs.

Q4 — The Removal Trigger

"What would make you remove this plugin from the marketplace entirely?"

Populates the most severe anti_patterns and escalation_triggers.

Q5 — The Anti-Pattern Example

"Give me a specific example of a 'fix' or 'improvement' this plugin should refuse to make, even if asked."

Most useful for alignment checks. Concrete refusals become escalation_triggers keywords.

AI Draft Procedure

When invoked (during Phase 0.6 of plugin lifecycle, or standalone):

  1. Read the plugin's existing files: plugin.json or .claude-plugin/plugin.json, CLAUDE.md if present, SKILL.md files
  2. Read discuss-CONTEXT.md if this is a new plugin creation
  3. Draft mission.json with status: "draft". Populate all fields from observed design choices and stated preferences.
  4. Write mission.json to the plugin root directory
  5. Write the interview file to .plugin-creator/plans/{plugin-name}/mission-interview.md — same convention plugin-lifecycle already uses for its own research/design scratch files — containing the 5 questions and the current draft mission field
  6. Update mission.json with "interview_file": ".plugin-creator/plans/{plugin-name}/mission-interview.md"
  7. Report: path of draft written, path of interview file, 2-3 sentence summary of draft mission

Validation Scenario Format

After interview, validate by running known decisions through the statement. Add each to validated_scenarios:

{
  "validated_scenarios": [
    {
      "decision": "Refused to add blanket noqa suppression to a linting plugin",
      "predicted_by": "anti_patterns[0] + escalation_triggers",
      "outcome": "correct"
    }
  ]
}

Status becomes "active" when it correctly predicts at least 3 known decisions.

Standalone Invocation

Arguments: <invocation_args/>

  • <plugin-path> — Draft mission for an existing plugin. Read plugin files, draft mission.json, create backlog interview item.
  • <plugin-path> --interview — Conduct the interview synchronously in this session. Ask Q1-Q5, update mission.json from answers, move to validation.
  • <plugin-path> --validate — Run validation scenarios. Ask human to confirm 3 past decisions, check predictions.

Relationship to Alignment Check

The escalation_triggers list is the fast path for alignment checking — pure string matching, no LLM:

  1. Check proposed action text against escalation_triggers — if any keyword matches, escalate immediately
  2. If no keyword match, check anti_patterns with LLM reasoning against mission and values
  3. If action contradicts anti_patterns or moves away from values, return alignment: LOW with the specific violated principle

The mission statement answers "what would the human say if they were watching?" — codified in advance.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Add automated documentation updater to any Claude skill. Creates a Python sync script that downloads upstream docs, processes markdown for AI consumption, and maintains local cache with configurable refresh. Collects template variables, then delegates implementation through 5-phase workflow. Use when adding auto-updating reference documentation to plugins or skills.

日本語の概要は準備中です。原文の説明を表示しています。

Jamie-BitFlight/claude_skills672026年10月12日 更新

SAM-style feature initiation workflow — discovery through codebase analysis, architecture spec, task decomposition, validation, and context manifest. Use when a user asks to add a feature, plan a feature, or convert an idea into an executable SAM plan.

日本語の概要は準備中です。原文の説明を表示しています。

Jamie-BitFlight/claude_skills672026年10月12日 更新

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

日本語の概要は準備中です。原文の説明を表示しています。

Jamie-BitFlight/claude_skills672026年10月12日 更新

Browser automation for AI agents using the agent-browser CLI and Playwright. Use when navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, logging into sites, or automating any browser task. Triggers on "open a website", "fill out a form", "click a button", "scrape data", "test this web app", "automate browser actions", or any programmatic web interaction request.

日本語の概要は準備中です。原文の説明を表示しています。

Jamie-BitFlight/claude_skills672026年10月12日 更新

Runs the description-drift experiment — spawns all Claude Code agents simultaneously to collect self-reported capabilities, then compares them against static frontmatter descriptions to reveal how reliable orchestrator routing based on descriptions actually is. Use when measuring description drift across the agent fleet, re-running the capability collection experiment, analyzing a specific agent's self-reported capabilities, or auditing whether frontmatter descriptions accurately reflect agent behavior.

日本語の概要は準備中です。原文の説明を表示しています。

Jamie-BitFlight/claude_skills672026年10月12日 更新

Create or adapt Claude Code agent definitions. Use when creating an agent, changing subagent configuration, selecting agent scope, or designing a specialized delegation role.

日本語の概要は準備中です。原文の説明を表示しています。

Jamie-BitFlight/claude_skills672026年10月12日 更新

Jamie-BitFlight のスキルをすべて見る

このスキルの問題を報告する