analyze

Files (5)

• SKILL.md
• question-output.md · assets/
• success-output.md · assets/
• analyze-rules.md · references/
• score_requirement.py · scripts/

SKILL.md (first lines)

# Analyze (Entry)

> Read the evidence first, then separate the objective, deliverable, and candidate path.

## When to activate

- Entering the analysis phase (`workflow` / `plan_only`).
- Need requirement scoring, clarification, or complexity routing.

## Execution skeleton

1. Load `references/analyze-rules.md` first.
2. Read user-supplied material and relevant code, separate the objective, deliverable, and candidate path, then score completeness.
3. If the score is below threshold, follow `auto_decide`:
   - `false`: ask follow-up questions with `assets/question-output.md`.
   - `true`: state explicit assumptions, then continue.
4. After the score passes, hand off confirmed success criteria, scope, evidence, and unknowns that could still affect the result.
5. Render the phase summary with `assets/success-output.md`.

## Resource navigation

- Long rules: `references/analyze-rules.md`
- Shared writing standards: `../references/shared-writing-dna.md` (apply to all output)
- Output contract: `../references/output-contract.md` (required sections, conditional enhancement, self-check)
- Follow-up template: `assets/question-output.md`
- Success template: `assets/success-output.md`
- Deterministic scoring script: `scripts/score_requirement.py`

## Deterministic logic first

Use the script when the score must be auditable:

```bash
python3 skills/en/skills/sopify/analyze/scripts/score_requirement.py \
  --goal-clarity 2 \
  --expected-outcome 2 \
  --scope-boundary 1 \
  --constraints 1 \
  --require-score 7
```

The script returns JSON with total score, threshold result, and missing dimensions.

## Boundaries

- This skill does not generate a plan package directly; hand off to `design`.
- This skill does not execute code changes directly; hand off to `develop`.

From evidentloop/sopify, Apache-2.0.

More from evidentloop/sopify