examples

name	examples
description	This skill should be used when the user asks for "macstack examples", "show a full macstack.json example", "how does a complete macstack.json look", "walk me through a macstack scenario", or needs an end-to-end scenario walkthrough for this plugin's skills.

MACSTACK Examples & Scenarios

Reference files

Canonical full examples live in the standard's repository (docs/macstack/examples/ of the MACSTACK standard repo):

• nova-root — an organization's root workspace (composable v1): the substacks registry, the openclaw→claude-code agent hierarchy, the organization's master client entity.
• nova-website — an Application/Web substack: a cross-stack lead master (master: "nova-root:postgresql"), 5 trigger types, a managed agent invoked via workflow.
• nova-support-bot — a headless Agents Stack: no prototype, RAG (PG master + Qdrant cache), a managed agent invoked via workflow/api.
• meg-bpms — a client BPMS: field-level ACL, status fields driving processes, an external master (hosting: "external").

Scenario A — an existing project without macstack.json

/macstack-dev:init
→ setup (tooling check) → init-project (code audit → draft + questions)
→ lint → CLAUDE.md section → infisical-env (if keys exist) → best-practices

Scenario B — a new stack from scratch

/macstack-dev:generate "an agency: website lead intake, client management, reports"
→ generate-stack (goals→results→processes→software, result-first)
→ discover-context (plugins + prototype) → lint → user confirms the results
→ /macstack-dev:scaffold → prototype → stack plugins → dev plugins → files
→ infisical-env → best-practices → lint → commit

Scenario C — an organization: root + substacks

1. generate-stack for the root (Agents Workspace, composable) — stacks.role: root
2. generate-stack for the website — stacks.role: substack + root ref;
   entities.lead.master = "<root-id>:postgresql" (cross-stack)
3. scaffold each; both get registered in the root's substacks[]

Scenario D — updating a live stack

Adding Qdrant for semantic search:
1. macstack.json: software += qdrant (databases/ready_made/data, agentic full),
   instances, connections.mcp += qdrant-mcp, resources.accesses += QDRANT_URL,
   workflows += wf-embed + trg-nightly
2. /macstack-dev:lint → /macstack-dev:scaffold (grows idempotently)
3. infisical-env: add the key to Infisical → /secrets-sync
4. Commit per the macstack-sync rule (spec and code in one commit)