---
title: "Plan the next project development stage"
method: POST
path: "/api/v1/project-development/plan"
tags: ["Discovery"]
---

# Plan the next project development stage

`POST /api/v1/project-development/plan`

## Request

- Base URL: `https://api.daystruct.ai`
- URL: `https://api.daystruct.ai/api/v1/project-development/plan`
- Auth: none required

Select up to four actual acquirable catalog releases for start/build/verify/resume. Outcomes remain caller-reported. No acquisition, execution, project storage or scheduled reminders. Send only a minimal caller-approved projection; keep full context, source and credentials local. MCP equivalent: plan_project_development.

## Request body

- object
  - `stage` 'start' | 'build' | 'verify' | 'resume', required
  - `goal` string, required
  - `stack` string[]
  - `features` string[]
  - `hasContext` boolean
  - `scopeNeedsDecision` boolean
  - `currentSourceRevision` string
  - `contextSourceRevision` string
  - `pending` object[]
    - `taskId` string, required
    - `title` string, required
    - `action` 'implement_and_verify' | 'verify_at_current_revision' | 'repair_and_retest' | 'resolve_issue' | 'review_scope_change', required
  - `checks` object[]
    - `id` string, required
    - `taskId` string, required
    - `title` string, required
    - `result` 'passed' | 'failed' | 'unknown', required
    - `sourceRevision` string, required
    - `artifactPath` string, required
    - `artifactDigest` string, required
  - `needs` string[]: Optional explicit part needs; does not bypass exclusions in the project goal.
  - `impact` object: Caller-reviewed minimal result from local change-impact selection. Keep diff, paths, manifest and commands local. Stale or unknown current revisions cannot support affected-feature recommendations.
    - `sourceRevision` string, required
    - `features` string[], required
    - `coverageGaps` string[], required

## Response `200`

Recommendations with exact release metadata, gaps, evidence-referenced next actions and an optional return suggestion. executionVerified and projectComplete are false.

## Other responses

- `400`: Unsupported or invalid project projection
- `405`: Use POST
- `429`: Read quota exceeded

---

[API](https://skmtc.dev/daystruct/apis/daystruct-api.md) · [All operations](https://skmtc.dev/daystruct/apis/daystruct-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daystruct/apis/daystruct-api/revisions/8cd3c7f60e18?raw)
