feat(analyst): этапы задачи — аналитик раскладывает на steps с критериями готовности, dev идёт по ним

internal/analyst/analyst.go

@@ -53,10 +53,11 @@ type AnalystResponse struct {
 	Phase       string          `json:"phase"`
 	Title       string          `json:"title"`
 	Goal        string          `json:"goal"`
-	Repo        string          `json:"repo"`   // одиночный репо (обратная совместимость)
-	Repos       json.RawMessage `json:"repos"`  // список репо (основной); устойчив к строке
+	Repo        string          `json:"repo"`  // одиночный репо (обратная совместимость)
+	Repos       json.RawMessage `json:"repos"` // список репо (основной); устойчив к строке
 	Why         string          `json:"why"`
 	AC          string          `json:"ac"`
+	Steps       []storage.Step  `json:"steps"`
 	Questions   []string        `json:"questions"`
 	ChatReply   string          `json:"chat_reply"`
 	AbortReason string          `json:"abort_reason"`
@@ -86,6 +87,22 @@ func (r *AnalystResponse) reposList() []string {
 	return out
 }
 
+// stepsList возвращает этапы: модель может вернуть массив объектов либо
+// пустой/отсутствующий — тогда nil. Записи без title отбрасываются.
+func (r *AnalystResponse) stepsList() []storage.Step {
+	if r.Steps == nil {
+		return nil
+	}
+	var out []storage.Step
+	for _, st := range r.Steps {
+		if st.Title == "" {
+			continue
+		}
+		out = append(out, st)
+	}
+	return out
+}
+
 // Decide реализует core.Decider через открытый код.
 func (a *Analyst) Decide(ctx context.Context, history []core.Message, draft storage.Task, force bool) (core.Decision, error) {
 	agent := a.Agent
@@ -109,6 +126,7 @@ func (a *Analyst) Decide(ctx context.Context, history []core.Message, draft stor
 		Repos:   draft.EffectiveRepos(),
 		Why:     draft.Why,
 		AC:      draft.AC,
+		Steps:   draft.Steps,
 		History: hist,
 		Force:   force,
 	}
@@ -176,6 +194,9 @@ func (a *Analyst) Decide(ctx context.Context, history []core.Message, draft stor
 	if ar.AC != "" {
 		dec.Draft.AC = ar.AC
 	}
+	if steps := ar.stepsList(); len(steps) > 0 {
+		dec.Draft.Steps = steps
+	}
 
 	return dec, nil
 }
@@ -204,7 +225,7 @@ func validateResponse(ar *AnalystResponse) error {
 			return fmt.Errorf("phase=ask, но нет ни chat_reply, ни questions")
 		}
 	case "propose":
-		if ar.Title == "" && ar.Goal == "" && len(ar.Repos) == 0 && ar.Why == "" && ar.AC == "" {
+		if ar.Title == "" && ar.Goal == "" && len(ar.Repos) == 0 && ar.Why == "" && ar.AC == "" && len(ar.stepsList()) == 0 {
 			return fmt.Errorf("phase=propose, но нет ни одного изменённого поля")
 		}
 	case "ready":
@@ -257,9 +278,22 @@ func formatVerdict(ar *AnalystResponse) string {
 		b.WriteString(", ac=")
 		b.WriteString(ar.AC)
 	}
+	if steps := ar.stepsList(); len(steps) > 0 {
+		b.WriteString(", steps=[")
+		var parts []string
+		for _, st := range steps {
+			s := st.Title
+			if st.AC != "" {
+				s += " → " + st.AC
+			}
+			parts = append(parts, s)
+		}
+		b.WriteString(strings.Join(parts, " | "))
+		b.WriteString("]")
+	}
 	if ar.AbortReason != "" {
 		b.WriteString(", abort_reason=")
 		b.WriteString(ar.AbortReason)
 	}
 	return b.String()
-}
+}

internal/analyst/analyst_test.go

@@ -24,7 +24,7 @@ func (m *mockRunner) Run(_ context.Context, _, _, _, _ string) (*opencode.Result
 
 func TestDecideAsk(t *testing.T) {
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"ask\",\"chat_reply\":\"Уточню про репозиторий\",\"questions\":[\"Где лежит код?\",\"Какая цель?\"]}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -46,7 +46,7 @@ func TestDecideAsk(t *testing.T) {
 
 func TestDecidePropose(t *testing.T) {
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"propose\",\"title\":\"Калькулятор\",\"goal\":\"Сделать веб-калькулятор\",\"repo\":\"tools/calc\",\"why\":\"Нужен для учёта\",\"ac\":\"Работает + - * /\",\"chat_reply\":\"Готово!\"}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -72,7 +72,7 @@ func TestDecidePropose(t *testing.T) {
 
 func TestDecideAbort(t *testing.T) {
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"abort\",\"chat_reply\":\"Это не про код.\",\"abort_reason\":\"Тема не подходит opencode\"}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -92,7 +92,7 @@ func TestDecideAbort(t *testing.T) {
 func TestDecideReady(t *testing.T) {
 	// ready с пустыми изменёнными полями — ВАЛИДНО (черновик готов как есть)
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"ready\",\"chat_reply\":\"Черновик готов, запускаю.\"}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -147,7 +147,7 @@ func TestEmptyHistory(t *testing.T) {
 
 func TestForceEmptyHistory(t *testing.T) {
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"ask\",\"chat_reply\":\"Опишите задачу.\"}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -159,7 +159,7 @@ func TestForceEmptyHistory(t *testing.T) {
 
 func TestInvalidPhase(t *testing.T) {
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"unknown\"}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -188,7 +188,7 @@ func TestNonZeroExit(t *testing.T) {
 func TestProposeEmptyFields(t *testing.T) {
 	// propose без изменённых полей — A3
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"propose\",\"chat_reply\":\"ok\"}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -205,7 +205,7 @@ func TestProposeEmptyFields(t *testing.T) {
 func TestAskEmptyReplyAndQuestions(t *testing.T) {
 	// ask без chat_reply и questions — A3
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"ask\"}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -223,7 +223,7 @@ func TestAskEmptyReplyAndQuestions(t *testing.T) {
 // парсер должен нормализовать и не падать.
 func TestDecideProposeStringRepos(t *testing.T) {
 	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
-		RC: 0,
+		RC:     0,
 		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"propose\",\"title\":\"Калькулятор\",\"repos\":\"tools/calc, tools/ui\"}"}}`,
 	}}, Worktree: "/tmp"}
 
@@ -240,6 +240,52 @@ func TestDecideProposeStringRepos(t *testing.T) {
 	}
 }
 
+// TestDecideProposeSteps — аналитик разложил задачу на этапы с критериями.
+func TestDecideProposeSteps(t *testing.T) {
+	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
+		RC:     0,
+		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"propose\",\"title\":\"Калькулятор\",\"steps\":[{\"title\":\"Модель\",\"ac\":\"операции + - * /\"},{\"title\":\"UI\"}]}"}}`,
+	}}, Worktree: "/tmp"}
+
+	history := []core.Message{{Role: "user", Content: "Сделай калькулятор"}}
+	dec, err := a.Decide(context.Background(), history, storage.Task{}, false)
+	if err != nil {
+		t.Fatalf("Decide err: %v", err)
+	}
+	if dec.Phase != "propose" {
+		t.Errorf("Phase = %q, want propose", dec.Phase)
+	}
+	if len(dec.Draft.Steps) != 2 {
+		t.Fatalf("len(Steps) = %d, want 2", len(dec.Draft.Steps))
+	}
+	if dec.Draft.Steps[0].Title != "Модель" || dec.Draft.Steps[0].AC != "операции + - * /" {
+		t.Errorf("Steps[0] = %q/%q, want Модель/операции + - * /", dec.Draft.Steps[0].Title, dec.Draft.Steps[0].AC)
+	}
+	if dec.Draft.Steps[1].Title != "UI" || dec.Draft.Steps[1].AC != "" {
+		t.Errorf("Steps[1] = %q/%q, want UI/(пусто)", dec.Draft.Steps[1].Title, dec.Draft.Steps[1].AC)
+	}
+}
+
+// TestProposeOnlyStepsValid — propose меняет только steps → валидно.
+func TestProposeOnlyStepsValid(t *testing.T) {
+	a := &Analyst{Runner: &mockRunner{result: &opencode.Result{
+		RC:     0,
+		Stdout: `{"type":"text","part":{"text":"{\"phase\":\"propose\",\"steps\":[{\"title\":\"Шаг 1\"}],\"chat_reply\":\"Разбил на этапы\"}"}}`,
+	}}, Worktree: "/tmp"}
+
+	history := []core.Message{{Role: "user", Content: "test"}}
+	dec, err := a.Decide(context.Background(), history, storage.Task{}, false)
+	if err != nil {
+		t.Fatalf("Decide err: %v", err)
+	}
+	if dec.Phase != "propose" {
+		t.Errorf("Phase = %q, want propose", dec.Phase)
+	}
+	if len(dec.Draft.Steps) != 1 {
+		t.Fatalf("len(Steps) = %d, want 1", len(dec.Draft.Steps))
+	}
+}
+
 // TestFormatVerdict — человекочитаемое описание вердикта аналитика.
 func TestFormatVerdict(t *testing.T) {
 	tests := []struct {
@@ -301,4 +347,4 @@ func TestFormatVerdict(t *testing.T) {
 			}
 		})
 	}
-}
+}

internal/analyst/prompt.go

@@ -3,6 +3,8 @@ package analyst
 import (
 	"strings"
 	"text/template"
+
+	"github.com/kamelion/ratatoskr-go/internal/storage"
 )
 
 // promptTemplate — шаблон промпта для аналитика (opencode analyst-agent).
@@ -23,6 +25,7 @@ var promptTemplate = template.Must(template.New("analyst").Parse(`Ты — ан
 | repos | список репозиториев (имена на git-хосте; для связанных — все сразу) |
 | why | зачем это нужно, контекст |
 | ac | acceptance criteria — конкретный результат, что считается готовым |
+| steps | (опционально) разбиение задачи на этапы: список {title, ac} с критерием готовности каждого этапа |
 
 Изменяй в JSON только те поля, которые надо поменять; что менять не надо — пустой строкой.
 
@@ -51,6 +54,12 @@ var promptTemplate = template.Must(template.New("analyst").Parse(`Ты — ан
 {{- else}}  repos: (не задано){{end}}
 {{if .Why}}  why: {{.Why}}{{else}}  why: (не задано){{end}}
 {{if .AC}}  ac: {{.AC}}{{else}}  ac: (не задано){{end}}
+{{if .Steps}}
+  steps:
+{{- range .Steps}}
+    - {{.Title}}{{if .AC}} → {{.AC}}{{end}}
+{{- end}}
+{{- else}}  steps: (не задано){{end}}
 
 **Ответь строго JSON-объектом, без лишнего текста:**
 {
@@ -60,6 +69,7 @@ var promptTemplate = template.Must(template.New("analyst").Parse(`Ты — ан
   "repos": ["имя_репо_1", "имя_репо_2"],
   "why": "зачем (только если меняешь)",
   "ac": "критерии (только если меняешь)",
+  "steps": [{"title": "этап 1", "ac": "критерий этапа 1"}],
   "questions": ["вопрос 1", "вопрос 2"],
   "chat_reply": "твой ответ пользователю (на русском, естественно)",
   "abort_reason": "если phase=abort — причина"
@@ -73,6 +83,7 @@ type TemplateData struct {
 	Repos   []string
 	Why     string
 	AC      string
+	Steps   []storage.Step
 	History string // отформатированная переписка
 	Force   bool
 }
@@ -84,4 +95,4 @@ func RenderPrompt(data TemplateData) (string, error) {
 		return "", err
 	}
 	return buf.String(), nil
-}
+}