---
slug: "Proposal"
name: "Proposal"
type: "Data Structures"
layer: "Infrastructure"
ref: "Proposal#5d0a"
sema_id: "sema:Proposal#mh:SHA-256:5d0a98055eef6c963d4c9ec0403cac243720ce8927398032c19b4f5d8cc94506"
tags: ["Infrastructure","Data Structures"]
updated: 2026-11-11
mindscape: "bootstrap"
index_url: https://mindscape.pages.dev/bootstrap/index.json
url: https://mindscape.pages.dev/bootstrap/Proposal/
related: ["Act","Message","Transition","Consensus","Costeer","Costeer#eeda"]
---

# Proposal

A suggested course of action

Layer: Infrastructure · Category: Data Structures

## Mechanism

A structured payload proposing a specific [Act](https://mindscape.pages.dev/bootstrap/Act.md) or [Transition](https://mindscape.pages.dev/bootstrap/Transition.md). It supplies an identifier, the requested change, and its rationale to a decision-making process; a [Message](https://mindscape.pages.dev/bootstrap/Message.md) may carry the payload.

## Invariants

- `proposal_id` is unique within the consuming decision process.
- `action` identifies the requested act or transition and what it applies to.
- `justification` states at least one reason for the request.

## Failure modes

—

## Data schema

```json
{
  "type": "object",
  "required": [
    "proposal_id",
    "action",
    "justification"
  ],
  "properties": {
    "proposal_id": {
      "type": "string",
      "description": "Unique identifier"
    },
    "action": {
      "type": "string",
      "description": "The proposed action or transition"
    },
    "justification": {
      "type": "string",
      "description": "Why this action should be taken"
    },
    "proposer_id": {
      "type": "string",
      "description": "Who submitted the proposal"
    }
  }
}
```

## Builds on

- [Act](https://mindscape.pages.dev/bootstrap/Act.md) (Infrastructure; References)
- [Message](https://mindscape.pages.dev/bootstrap/Message.md) (Infrastructure; References)
- [Transition](https://mindscape.pages.dev/bootstrap/Transition.md) (Infrastructure; References)

## Used by

- [Consensus](https://mindscape.pages.dev/bootstrap/Consensus.md) (Society; Accepts)
- [Costeer](https://mindscape.pages.dev/bootstrap/Costeer.md) (Society; References)

## Identity

- Sema ID: `sema:Proposal#mh:SHA-256:5d0a98055eef6c963d4c9ec0403cac243720ce8927398032c19b4f5d8cc94506`
- Ref: `Proposal#5d0a`
- Supersedes:
  - `sema:Proposal#mh:SHA-256:48400f03d012e37914685f66064ccd4c3875efb0bb4dff24d88c8f1ca9aa247d`
  - `sema:Proposal#mh:SHA-256:5e96c86b24df6ee2910c5d4c8cc75531e10e402d2867bb68ed5dc04606e538f4`

## Links

- [Pattern page](https://mindscape.pages.dev/bootstrap/Proposal/)
- [View in the interactive graph](https://mindscape.pages.dev/bootstrap/#Proposal)
- [JSON](https://mindscape.pages.dev/bootstrap/Proposal.json)
- [Index of all patterns](https://mindscape.pages.dev/bootstrap/index.json)
