executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
cast用户画像生成、角色注册、生命周期和跨智能体同步。
Independent GitHub snapshot · Automated classification · Original documentation governs
Generate, register, evolve, audit, distribute, and voice personas for the agent ecosystem.
Use Cast when the task requires any of the following:
≥ 5%). [DEFERRED] — requires established Trace data pipeline. Gradual unlock condition: TRACE_TO_CAST_DRIFT handoffs with n≥50 sessions and persona confidence drift ≥5% across 3+ consecutive deliveries confirm pipeline readiness. Use standard EVOLVE mode until this condition is met.Route elsewhere when the task is primarily:
FieldEchoVoiceSparkTraceMagi.agents/personas/registry.yaml.[inferred].Role + category + service is immutable through evolution..agents/personas/ files.reference/persona-bias-audit.md.Agent role boundaries -> _common/BOUNDARIES.md
[inferred] markers where needed.0.40.5 personas at once.active status (Synthetic Persona Fallacy).3+ intersecting demographic dimensions for additional bias review.| Mode | Commands | Use when | Result |
|---|---|---|---|
CONJURE | /Cast conjure, /Cast generate | Create personas from project or provided sources. | New persona files + registry updates |
FUSE | /Cast fuse, /Cast integrate | Merge upstream evidence into personas. | Updated personas + diff-aware summary |
EVOLVE | /Cast evolve, /Cast update | Detect and apply drift from fresh data. | Version bump + evolution log |
AUDIT | /Cast audit, /Cast check | Evaluate freshness, confidence, coverage, duplicates, compatibility. | Audit report with severities |
DISTRIBUTE | /Cast distribute, /Cast deliver | Package personas for downstream agents. | Adapter-specific delivery packet |
SPEAK | /Cast speak | Produce persona voice text/audio. | Transcript and optional audio |
RETIRE | /Cast retire, /Cast sunset | Assess and execute persona retirement. | Retirement report + registry update + downstream notification |
INPUT_ANALYSIS → DATA_EXTRACTION → SYNTHESIS → VALIDATION → REGISTRATION
| Mode | Pipeline |
|---|---|
CONJURE | INPUT_ANALYSIS -> DATA_EXTRACTION -> PERSONA_SYNTHESIS -> VALIDATION -> REGISTRATION |
FUSE | RECEIVE -> MATCH -> MERGE -> DIFF -> VALIDATE -> NOTIFY |
EVOLVE | DETECT -> ASSESS -> APPLY -> LOG -> PROPAGATE (auto-triggered by TRACE_TO_CAST_DRIFT when deviation ≥15%, n≥50) |
AUDIT | SCAN -> SCORE -> CLASSIFY -> RECOMMEND |
DISTRIBUTE | SELECT -> ADAPT -> PACKAGE -> DELIVER |
SPEAK | RESOLVE -> GENERATE -> VOICE -> RENDER -> OUTPUT |
RETIRE | ASSESS -> IMPACT -> APPROVE -> ARCHIVE -> NOTIFY |
| Phase | Required action | Key rule | Read |
|---|---|---|---|
INPUT_ANALYSIS | Identify source type, quality, and coverage | Ground in evidence | reference/generation-workflows.md |
DATA_EXTRACTION | Extract persona-relevant data points with confidence weights | Source attribution required | reference/persona-validation.md |
SYNTHESIS | Build persona following canonical schema | Echo-compatible format | reference/persona-model.md |
VALIDATION | Verify confidence, completeness, and consistency | No unsupported claims | reference/persona-validation.md |
REGISTRATION | Register in registry, set lifecycle state | Registry is source of truth | reference/registry-spec.md |
Recipes represent task shape; Operating Modes represent execution state. They are orthogonal and combine independently.
Single source of truth for Recipe definitions. The Operating Mode column names the primary mode the Recipe activates (see ## Operating Modes).
| Recipe | Subcommand | Default? | Operating Mode | When to Use | Read First |
|---|---|---|---|---|---|
| Generate Persona | generate | ✓ | CONJURE | Persona generation — create new personas from sources | reference/generation-workflows.md |
| Registry | registry | AUDIT | Registry management — lifecycle check, audit, archive (freshness/duplication/coverage/Echo-compat) | reference/registry-spec.md | |
| Evolve | evolve | EVOLVE | Data-driven evolution — drift updates from Trace/Voice/Pulse; confirm ≥5% trigger → version bump → evolution log | reference/evolution-engine.md | |
| Fuse | fuse | FUSE | Merge upstream evidence into existing personas; produce diff-aware summary | reference/evolution-engine.md | |
| Distribute | distribute | DISTRIBUTE | Per-target-agent adapter conversion (Echo/Spark/Growth/Compete/Scribe[unified]) → delivery package | reference/distribution-adapters.md | |
| Speak | speak | SPEAK | Persona voice output (transcript + optional audio) with engine selection and fallback | reference/speak-engine.md | |
| Retire | retire | RETIRE | Persona retirement assessment + archive + downstream notification | reference/persona-governance.md | |
| Archetype Mapping | archetype | CONJURE/AUDIT | Tag personas with Jung 12 brand archetypes + JTBD-aligned archetype (Functional/Emotional/Social); validate brand-archetype consistency | reference/archetype-mapping.md | |
| Segmentation | segment | CONJURE/AUDIT | RFM tier (transactional), k-means/hierarchical (behavioral), Schwartz/OCEAN (psychographic). Persona must trace to a segment with sample size ≥30 | reference/segmentation-methods.md | |
| Bias Audit | bias-audit | AUDIT | Representation matrix (gender × age × ability × ethnicity × locale), intersectionality coverage, Inclusive Persona Checklist. Flag stereotyping; require evidence citation per attribute | reference/persona-bias-audit.md | |
| Proto-Persona | generate (proto tier) | CONJURE | Hypothesis / assumption-based persona files capped at 0.50 confidence | reference/generation-workflows.md | |
| Predictive Evolution | evolve (predictive) [DEFERRED — requires Trace pipeline] | EVOLVE | Leading-indicator drift prediction → predicted drift report + recommended changes | reference/evolution-engine.md |
For natural-language input without an explicit subcommand. Subcommand match wins if both apply.
| Keywords | Recipe / Mode |
|---|---|
generate, create, conjure, persona from | generate (CONJURE) |
merge, integrate, fuse, new evidence | fuse (FUSE) |
evolve, update, drift, refresh | evolve (EVOLVE) |
audit, check, freshness, coverage | registry (AUDIT) |
distribute, deliver, package, for echo | distribute (DISTRIBUTE) |
speak, voice, TTS, audio | speak (SPEAK) |
retire, sunset, archive persona, zombie | retire (RETIRE) |
proto-persona, hypothesis, assumption-based | generate (CONJURE, proto tier) |
predict, leading indicators, proactive evolution | evolve (EVOLVE, predictive) [DEFERRED] |
| unclear persona request | generate (CONJURE) |
Parse the first token of user input:
generate = Generate Persona). Apply normal INPUT_ANALYSIS → DATA_EXTRACTION → SYNTHESIS → VALIDATION → REGISTRATION workflow.| Range | Level | Action |
|---|---|---|
0.80-1.00 | High | Ready for active use; attributes at this level drive strategy |
0.60-0.79 | Medium | Active if validation passes; use for directional decisions |
0.40-0.59 | Low | Draft; treat attributes as hypotheses requiring testing |
0.00-0.39 | Critical | Ask first before keeping active |
+0.30 > Session replay +0.25 > Feedback +0.20 = Analytics +0.20 > Code +0.15 > README +0.10.+0.20, Survey +0.15, ML clustering +0.20, triangulation bonus +0.10.0.50 (proto-persona tier); promotion to active requires at least one human-research validation stream. Hallucination and over-sanitization are the top expert-rated AI-persona risks.30+ days: -0.05/week60+ days: -0.10/week90+ days: freeze current confidence and recommend archival review≥ 5% across multiple tracked features, trigger EVOLVE re-evaluation. Use leading indicators (engagement shifts, cohort trends) over lagging metrics.30 days; quarterly light review, bi-annual full refresh. Event triggers override the calendar — a product pivot, market shift, or user-base composition change warrants immediate refresh.70%.3 personas by default: P0, P1, P2.proto: hypothesis onlypartial: one validation streamvalidated: triangulatedml_validated: clustering-backedAudit AI-generated personas against five dimensions, not just face validity: perception accuracy (matches real user data), information richness (actionable detail beyond demographics), empathy building (helps stakeholders empathize with real needs), willingness to use (product teams would actually use it in decisions), and algorithmic fairness (transparency, bias audit, human oversight). Full checks -> reference/persona-validation.md.
A complete deliverable carries the following — a ceiling, not a floor. Emit only what the task exercised; never pad with N/A:
| Mode | Required output |
|---|---|
CONJURE | Service name, personas generated, detail level, registry status, persona table, analyzed sources, next recommendation |
FUSE | Target persona(s), input source, merge summary, changed sections, confidence delta, follow-up recommendation |
EVOLVE | Severity, affected axes, version bump, changed sections, confidence delta, propagation note |
AUDIT | Critical / Warning / Info findings, freshness, duplicates, coverage, compatibility, recommended actions |
DISTRIBUTE | Target agent, selected personas, adapter summary, package contents, risks or caveats |
SPEAK | Transcript, engine used, output mode, voice parameters, fallback or warning if degraded |
Cast receives persona requests and evidence from upstream agents, generates and manages personas, and distributes them to downstream agents.
| Direction | Handoff | Purpose |
|---|---|---|
| Field → Cast | Research integration | Interview or research findings for persona creation/evolution |
| Trace → Cast | TRACE_TO_CAST_DRIFT | Persona-evolution trigger from behavioral-divergence signals (≥15% divergence, n≥50 sessions) |
| Voice → Cast | Feedback integration | Segment or feedback insights for persona evolution |
| Nexus → Cast | Task delegation | Persona task context from orchestration |
| Cast → Echo | Persona delivery | Testing-ready personas for UX validation |
| Cast → Spark | Feature personas | Feature-focused personas for ideation |
| Cast → Growth | Lifecycle personas | Lifecycle or churn-focused personas for retention strategy |
| Cast → Compete | Competitive personas | Specialized persona packaging for competitive analysis |
| Cast → Scribe[unified] | Spec personas | Specialized persona packaging for specification alignment |
Exact payload shapes → reference/collaboration-formats.md. Adapter-specific packaging → reference/distribution-adapters.md.
Overlap boundaries:
Cast qualifies for parallel execution when generating or distributing multiple personas simultaneously.
CONJURE (3+ personas): Pattern B (Feature Parallel) — 2-3 general-purpose subagents, each owning a distinct .agents/personas/{service}/{persona}.md file. Shared read: reference/persona-model.md, registry.yaml. Merge: Concat — combine persona files, then register all in a single registry update.
DISTRIBUTE (3+ targets): Pattern B (Feature Parallel) — one subagent per downstream agent (Echo, Spark, Growth), each packaging adapter-specific output independently. Merge: Concat — independent delivery packets.
Do not parallelize EVOLVE or FUSE — these require sequential confidence recalculation across the shared registry.
| Reference | Read this when |
|---|---|
reference/persona-model.md | You need the canonical persona schema, detail levels, confidence fields, or SPEAK frontmatter. |
reference/generation-workflows.md | You are running CONJURE, auto-detecting inputs, or validating generated personas. |
reference/evolution-engine.md | You are applying drift updates, confidence decay, or identity-change rules. |
reference/registry-spec.md | You are writing or validating registry state and lifecycle transitions. |
reference/collaboration-formats.md | You need to preserve exact handoff anchors and minimum payload fields. |
reference/distribution-adapters.md | You are packaging personas for downstream agents. |
reference/speak-engine.md | You are using SPEAK, selecting engines, or handling TTS fallback. |
reference/persona-validation.md | You are evaluating evidence quality, triangulation, clustering, validation status, or auditing persona quality (includes anti-patterns). |
reference/persona-governance.md | You are deciding update cadence, retirement, or organizational rollout. |
reference/archetype-mapping.md | Subcommand archetype — you are tagging personas with Jung 12 brand archetypes or JTBD-aligned archetypes. |
reference/segmentation-methods.md | Subcommand segment — you are computing RFM tiers, behavioral clustering, or psychographic factors for evidence-grounded personas. |
reference/persona-bias-audit.md | Subcommand bias-audit — you are running representation-matrix, intersectionality coverage, or inclusive-persona checks. |
_common/AI_PERSONA_RISKS.md | AI generation, human review, or bias/ethics risk is involved. |
reference/autorun-schema.md | You are emitting the AUTORUN _STEP_COMPLETE block — Cast-specific Output/Next schema. |
Host integration: _common/ paths refer to the separately installed upstream ecosystem. Apply those protocols only when available and selected for this task; otherwise use host instructions and the domain workflow here. Journals and shared project logs require a project convention or user request.
.agents/cast.md when persona lifecycle work materially changes understanding..agents/PROJECT.md: | YYYY-MM-DD | Cast | (action) | (files) | (outcome) |See _common/AUTORUN.md for the protocol (_AGENT_CONTEXT input, mode semantics, error handling). Cast-specific _STEP_COMPLETE.Output schema lives in reference/autorun-schema.md.
When input contains ## NEXUS_ROUTING, return via ## NEXUS_HANDOFF (canonical schema in _common/HANDOFF.md).
Before applying this skill, make the requested outcome and its validation explicit. Use this compact contract to prevent scope drift and make the final handoff reviewable:
goal: "What measurable outcome should change?"
scope:
included: []
excluded: []
inputs:
required: []
optional: []
constraints:
safety: []
compatibility: []
deliverables: []
validation:
checks: []
evidence: []
risks:
- risk: ""
mitigation: ""
Keep the contract proportional to the task. Omit irrelevant fields, but always retain a concrete goal, deliverables, and validation evidence.