Skip to content

Teach craft-prompt to gather /goal contract inputs #31

@sungjunlee

Description

@sungjunlee

Problem

craft-prompt already references /goal completion conditions, but its main workflow does not explicitly gather the fields that make a goal safe to run for many turns.

This can lead to weak goal prompts that name the task but omit completion evidence, non-goals, scope, budget, or blocked-stop behavior.

Proposed change

Update skills/craft-prompt/SKILL.md so Step 2 includes a Goal condition / Goal spec raw-material type.

It should gather, when relevant:

  • outcome: what must be true when complete
  • evidence: command, artifact, report, source, or transcript-visible proof
  • constraints: behavior, APIs, files, compatibility, style, data, or performance that must not regress
  • non-goals: what the agent should avoid even if it seems useful
  • scope: allowed files, repos, tools, network, credentials, and data sources
  • budget: turn, time, token, command, or cost cap
  • blocked stop condition: when to stop and what to report

Acceptance criteria

  • craft-prompt explicitly recognizes /goal work as a distinct prompt type.
  • The workflow remains cross-agent and avoids Codex-only wording in the main spine.
  • The change is small and points detailed guidance to references/goal-conditions.md rather than bloating SKILL.md.
  • Korean trigger wording such as goal 조건 still makes sense with the updated description.

Notes

This came from reviewing the /goal guidance against goal-setter, Codex docs, Claude Code docs, craft-survey, craft-critique, plan-eng-review, and simplify perspectives.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area: docsDocumentation and README workcraft-reviewWork derived from CraftKit skill reviewpriority: highHigh prioritytype: taskConcrete implementation task

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions