Claude-Mind: Skill for Claude Code

/aspirations-complete-review — Aspiration Completion Review

Invoked by the orchestrator when an aspiration has ALL non-recurring goals completed: sweeps outcomes for outstanding work, checks needle/motivation fulfillment, decides archive vs reopen.

Step 0: Load Conventions — Bash: load-conventions.sh with each name from the conventions: front matter. Read only the paths returned (files not yet in context). If output is empty, all conventions already loaded — proceed to next step.

Inputs (from orchestrator)

• asp: The completing aspiration object (from compact loader)
• goal: The goal that triggered completion (last completed goal)
• goals_completed_this_session: Counter for maturity check
• source: Queue origin ("world" or "agent") — pass --source {source} to all aspirations-*.sh calls

Outputs (to orchestrator)

• goals_added_to_completing_asp: Count of new goals added (if > 0, aspiration is reopened)
• should_archive: Boolean (true if aspiration should be archived)

Phase 7: Aspiration-Level Check

Re-read the goal's parent aspiration via compact loader. GUARD: aspirations with ANY recurring goals cannot be archived (aspirations-complete.sh blocks it); check here first.

asp = get_aspiration(goal)
has_recurring = any(g.get("recurring", False) for g in asp.goals)

# ── Functionally Complete Path ──
# An aspiration with recurring goals where ALL non-recurring goals are done.
# The aspiration's original PURPOSE has been achieved — only monitoring remains.
# We do NOT archive (data layer blocks it), but we DO generate replacement work.
if has_recurring and functionally_complete:
    # Guard: only fire once per aspiration (prevent repeated triggering)
    IF asp.functionally_complete_at is not null:
        RETURN (should_archive = false, goals_added = 0)  # already processed
    # ASPIRATION-FIELD setter, NOT aspirations-meta-update.sh (g-115-2592: that
    # one wrote a spurious meta key and dropped the timestamp → zombie re-flags).
    Bash: aspirations-update.sh --source {source} {asp.id} functionally_complete_at "$(date +%Y-%m-%dT%H:%M:%S)"

    Output: "▸ Functionally complete: {asp.id} '{asp.title}' — all non-recurring goals done, {recurring_count} recurring continue"
    run_aspiration_spark(goal.aspiration)
    # SELF-GENERATED (g-357-82): origin `successor:{asp.id}`, never
    # `user_directive`; needs supply_evidence citing {asp.id}. The supply gate
    # refuses a successor restating the completed work; EMPTY is expected.
    invoke /create-aspiration from-self --plan with:
        origin_signal: "successor:{asp.id}"
        replacement_context: "Aspiration '{asp.title}' is functionally complete (recurring goals continue as monitoring). Generate a NEW aspiration advancing the agent's purpose in a fresh direction, informed by its outcomes."
    RETURN (should_archive = false, goals_added = 0)  # keep alive for recurring, but replacement was triggered

# ── Standard recurring guard ──
if has_recurring: RETURN (should_archive = false, goals_added = 0)  # not yet functionally complete
# Note: the `aspiration_fully_complete(asp)` gate now lives AFTER Phase 7.4 so
# zombie aspirations (mostly complete, trailing blocked goals) can reach it.