plan
Author the research plan — fundamentals first, trade ideas last; Constitution Check evaluated twice; Deviation Register with mandatory Expiry; emits the four side artifacts (brief/entities/reproduce/c
SKILL.mdplugins/vertical-plugins/scenarios/skills/agentii/plan/SKILL.md
GitHubagentii.plan
Ordering rule (Q35/Q36)
The plan starts with business understanding and ends with dateable catalysts +
sizing. Constitution Check runs twice: plan start (scalar + scope) and after
sizing (aggregate — position_pct exists only then).
Side artifacts
| artifact | content | hard requirement |
|---|---|---|
brief.md |
stage-0 context brief — Q18 retrieval keys (mechanical prefilter → pillar FTS → cold-start fallback); strategies top-N 3–5 with a method_selection: verdict each (Q7); <ref:*> framed blocks; corpus_version pin |
— |
entities.md |
entity_claims schema + entity/metric map | market_data_stage: early theses MUST define the bars schema (Q42) — without it, implement refuses |
reproduce.md |
skills + five pins + as_of |
— |
contracts/ |
output frontmatter schemas + requires: declarations |
— |
Deviation Register (Q35)
An accepted violation without Constraint | Why Accepted | Safer Alternative Rejected Because | Approver | Expiry means the plan is not complete —
agentii.plan must not report success. Every deviation carries an Expiry;
converge re-proposes re-justification at expiry.
Invocation
# Resolve the kit root first — contracts/kit-root.md. The kit's scripts do NOT ship
# with the skills, so never assume the CWD is the checkout.
KIT=""
for c in "${AGENTII_KIT_ROOT:-}" \
"$(cat "$HOME/.claude/skills/agentii/.kit-root" 2>/dev/null)" \
"${CLAUDE_PLUGIN_ROOT:-}"; do
[ -n "$c" ] && [ -f "$c/scripts/agentii_cmd.py" ] && { KIT="$c"; break; }
done
if [ -z "$KIT" ]; then d="$PWD"; while [ "$d" != "/" ]; do
[ -f "$d/scripts/agentii_cmd.py" ] && { KIT="$d"; break; }; d="$(dirname "$d")"; done; fi
[ -n "$KIT" ] || { echo "agentii kit not found — see contracts/kit-root.md" >&2; exit 1; }
python3 "$KIT/scripts/agentii_cmd.py" plan --thesis theses/001-ai-semiconductors
Gate 2 (after plan, informational) shows phases + the Deviation Register.