draft-refine

draft-refine

This is an OpenCode-native Skill projection generated from the portable capability contract. It is adapter-owned output, not a legacy compatibility Skill copy.

Source

• Portable source: capabilities/draft-refine.md
• Runtime check: adapters/opencode/bin/preflight.sh capability-info draft-refine
• Bootstrap: adapters/opencode/AGENTS.md

Use

1. Read capabilities/draft-refine.md for the runtime-neutral contract.
2. Run adapters/opencode/bin/preflight.sh capability-info draft-refine.
3. Obey the reported status:
   • instruction-only: use this Skill as OpenCode guidance plus explicit preflight guards.
   • tool-contract: report the named tool_contract, run any tool_contract_check, and obey runtime_surface / fallback before claiming full support.
   • unsupported: stop or use the reported fallback.

Shape

• Identifier: draft-refine
• Invocation class: parent-invoked
• Supported modes: none
• Argument shape: <strategy or draft name or path> [--intensity direct|quick|standard|strong|thorough|adversarial]
• Portable meaning: Refine a draft by applying memo/review feedback to a document strategy or draft.

Portable Contract

• Invocation semantics: Reflect user memos/review feedback in a document strategy or draft. Before rewriting an existing file, obtain the route-bound utilities/artifact-snapshot.py receipt; it preserves exact prior bytes under _internal/versions/v{N}/ (modern; per CONVENTIONS.md §5) or _v{N}.md siblings (legacy). The model never allocates or copies versions manually. Auto-managed changelog: array inside YAML frontmatter (NOT a top-of-file HTML comment — that breaks markdown preview when frontmatter is also present). Mandatory ref-grounding per memo (re-read source; override memo if it conflicts with source). Adapters may expose this capability through native commands, skill files, prompt instructions, or explicit wrappers. The adapter must report unsupported runtime mechanics instead of silently treating another runtime's native file format as portable.

Projected Portable Details

Artifact Ownership

Artifact root: core/CONVENTIONS.md §5.1; output placement: §5.

Artifact Producer Lifecycle

draft-refine is a standard+ stage worker: it never issues its own campaign or cycle. It receives the owner's open cycle through AGENT_ARTIFACT_CAMPAIGN_ID/AGENT_ARTIFACT_CYCLE_ID/AGENT_ARTIFACT_PRODUCER_ID/ AGENT_ARTIFACT_CYCLE_DIR/AGENT_ARTIFACT_OUTPUT_DIR (dispatch env pass-through); the resolver applies the selected node's declared outputs and write scope while preserving the existing draft target. artifact_producer.py owns the open cycle and its output paths; finalize and admit-shared belong to the owner, never to a stage worker. See producer_lifecycle in capabilities/topologies.json.

Role Requirements

Use portable role names from roles/README.md and core/CONVENTIONS.md. Concrete model names, subagent frontmatter, and runtime-specific tool lists belong in adapter files.

Guard Requirements

Adapters must preserve the portable invariants relevant to this capability:

• resolve artifact root through utilities/artifact-root.sh or equivalent logic;
• use DB memory paths, not runtime-native memory files.

Portable procedure and reference documents are owned under capabilities/draft-refine/references/ when present. Claude, Codex, and OpenCode Skill bodies are generated projections of this capability and use the same logical procedure read-set.

Shared Procedure References

Read the complete portable procedure files listed here when they apply; this logical read-set is shared across Claude, Codex, and OpenCode.

• capabilities/draft-refine/references/changelog-example.md
• capabilities/draft-refine/references/delegate-prompt.md
• capabilities/draft-refine/references/procedure.md

Workflow Evidence

• For workflow state: adapters/opencode/bin/preflight.sh status [cwd] [session-id] and adapters/opencode/bin/preflight.sh prompt-signal [cwd] [session-id]

Do not use legacy compatibility Skill files or non-native adapter Skill files as OpenCode-native source. Those files are compatibility/reference surfaces only.