Strategy session brief

Session agenda, cost decisions and founder questions.

Kind: strategy_brief
Availability: available
Registry cost category: one_call
Lifecycle stage IDs: product_strategy_session

The cost category describes model work in the registry; it is not a manufacturing price or a monetary quote. Read maglev actions kinds --json for current availability and schemas.

What this does

Returns a draft for review against the project brief and supporting evidence. A completed action does not establish that a physical test, production gate or engineering review has passed.

Input

Send these fields inside the request’s input object. Use only facts you have, and keep unresolved requirements explicit. Optional fields with defaults can be omitted.

Field	Type	Required	Details
`goals`	string[]	No	Max items 30
`constraints`	string[]	No	Max items 30
`questionsFromFounder`	string[]	No	Max items 30

Input JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "goals": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 1000
      }
    },
    "constraints": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 1000
      }
    },
    "questionsFromFounder": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 1000
      }
    }
  }
}

Example request

Synthetic example for action.json; adapt it to your reviewed brief.

{
  "kind": "strategy_brief",
  "input": {
    "goals": [
      "Prepare a first 100-unit enclosure build"
    ],
    "constraints": [
      "Quality before price",
      "US manufacturing required",
      "Tolerances remain unknown"
    ],
    "questionsFromFounder": [
      "Which missing details prevent a useful quote?"
    ]
  }
}

Replace PROJECT_ID with your saved project ID. Use a new idempotency key for new work and retain it for an identical retry.

maglev actions request PROJECT_ID --input action.json \
  --idempotency-key example-strategy-brief-001 --json

Read action.status, action.output, deliveries and any task in the response. Model actions can take several minutes. After a timeout, check saved actions before retrying. See request and recovery behavior.

Output

The schema below describes action.output.result. The saved action.output envelope also contains draft: true and a note. It can be null while an action is running or after a failure; check the status before reading the result. Null or missing facts are unknown; preserve source references and open questions.

Field	Type	Required	Details
`agenda`	object[]	Yes
`agenda[].topic`	string	If parent supplied
`agenda[].minutes`	integer or null	If parent supplied	Minutes to give the topic, or null if there is no basis to size it
`agenda[].why`	string	If parent supplied
`questionsMaglevWillAsk`	string[]	Yes	Questions a factory would ask before quoting, in the order Maglev will ask them
`decisionsThatLockCost`	object[]	Yes
`decisionsThatLockCost[].decision`	string	If parent supplied
`decisionsThatLockCost[].whyItLocksCost`	string	If parent supplied
`decisionsThatLockCost[].whenToDecide`	string	If parent supplied
`standardPartCandidates`	string[]	Yes	Parts of this product that could be off the shelf or a standard size, named only from what the project and request describe
`whatWeSayAboutFees`	string	Yes
`assumptions`	string[]	Yes	What was assumed in order to write this draft
`openQuestions`	string[]	Yes	What only the founder, a factory or a lab can answer
`sources`	string[]	Yes	Repo paths of the passages actually relied on

Output JSON schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "agenda": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string"
          },
          "minutes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Minutes to give the topic, or null if there is no basis to size it"
          },
          "why": {
            "type": "string"
          }
        },
        "required": [
          "topic",
          "minutes",
          "why"
        ],
        "additionalProperties": false
      }
    },
    "questionsMaglevWillAsk": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Questions a factory would ask before quoting, in the order Maglev will ask them"
    },
    "decisionsThatLockCost": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "decision": {
            "type": "string"
          },
          "whyItLocksCost": {
            "type": "string"
          },
          "whenToDecide": {
            "type": "string"
          }
        },
        "required": [
          "decision",
          "whyItLocksCost",
          "whenToDecide"
        ],
        "additionalProperties": false
      }
    },
    "standardPartCandidates": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Parts of this product that could be off the shelf or a standard size, named only from what the project and request describe"
    },
    "whatWeSayAboutFees": {
      "type": "string"
    },
    "assumptions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "What was assumed in order to write this draft"
    },
    "openQuestions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "What only the founder, a factory or a lab can answer"
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Repo paths of the passages actually relied on"
    }
  },
  "required": [
    "agenda",
    "questionsMaglevWillAsk",
    "decisionsThatLockCost",
    "standardPartCandidates",
    "whatWeSayAboutFees",
    "assumptions",
    "openQuestions",
    "sources"
  ],
  "additionalProperties": false
}