opascope-define-donelisted
Install: claude install-skill opascope/skills
# Define done for an AI coding task
Read [shared.md](shared.md) first. Save the result with kind `objective`.
The deliverable is the sentence that means the user's pain is gone. Do not jump
from the problem to a feature or implementation plan.
1. Mirror the problem in the user's terms, including its tension. Gather only
missing context that would change the objective.
2. Write one sentence: "This is solved when ..." Describe the observable world
after the work, not "we build", "we create" or "we implement". Split distinct
problems into separate objectives rather than joining unrelated goals.
3. Try to falsify each clause. Replace words such as "better" or "streamlined"
with observable behavior. Ask what evidence would yield a clear yes or no.
4. Test the proxy trap: could every clause be true while the original pain
remains? If so, put the missing pain into the objective.
5. Stop at the requested altitude. Default: an alignment sentence, saved with
a short explanation of the pain and the falsifiability test. On a request
for measurable verification, add artifact pointers and a proof per clause.
Read [references/proofs.md](references/proofs.md) for that path.
Example: "Create a searchable folder" describes a solution. "This is solved
when a reader can find each note from its topic, and every original note is
preserved byte-for-byte" describes the end state. Counting an index file alone
would miss both retrieval and preservation.
An objective can na