PMCRO Cognitive Architecture Project Generator v2
Generates a complete, production-ready .NET 10 Aspire PMCRO project from three parameters.
Input Contract
| Parameter |
Example |
Description |
CompanyName |
Tooensure |
PascalCase company — becomes namespace root + folder prefix |
ProjectName |
CogArch |
PascalCase project — combined as CompanyName.ProjectName everywhere |
SeedIntent |
"Develop PMCR-O Cognitive Architecture" |
Injected into InitFrame, TRAIN-000, SKILL.md files, Directory.Build.props |
If any are missing, ask before generating.
Generation Workflow
- Confirm all three parameters.
- Run
scripts/generate_project.py --company X --name Y --intent Z --output /path/
- Script produces
CompanyName.ProjectName.zip.
- Present the ZIP via
present_files.
python3 /path/to/pmcro-v2/scripts/generate_project.py \
--company "CompanyName" \
--name "ProjectName" \
--intent "SeedIntent" \
--output /mnt/user-data/outputs/
What Gets Generated
See references/project-structure.md for the complete file tree.
Architecture
External REST (HTTP)
│
▼
OrchestrationApi (:8080)
│
│ gRPC (internal)
▼
OrchestratorService (:7075)
│ │ │ │
│ │ │ └─► ReflectorService (:7074) [gRPC]
│ │ └──────► CheckerService (:7073) [gRPC]
│ └───────────► MakerService (:7072) [gRPC]
└────────────────► PlannerService (:7071) [gRPC]
│
MCP Actuators (HTTP)
├── Mcp.FileSystem (:7221)
├── Mcp.Playwright (:7273)
└── Mcp.Git (:7222)
Key Pillars
Infrastructure:
Directory.Build.props — net10.0, C# latest, ArtifactsPath, SeedIntent MSBuild propertyDirectory.Build.targets — SKILL.md → output copy + VerifyPmcroIdentity targetDirectory.Packages.props — Central Package Management (ALL versions, no Version= in csproj).template.config/template.json — dotnet new pmcro -company X -name Y -intent Z
AppHost (Aspire):
- All services + MCPs registered with named endpoints
- WaitFor chains: phase agents wait for MCPs; Orchestrator waits for all phases; Api waits for Orchestrator
WithEnvironment("SeedIntent", ...) injected into every service
Phase Services (gRPC internal, MAF):
CompanyName.ProjectName.Contracts — shared .proto files + generated stubsPlannerService, MakerService, CheckerService, ReflectorService — each with SKILL.md + gRPC implOrchestratorService — governs the loop, issues EXTEND/ACCEPT/ESCALATE/LOOP/INTERRUPT verdictsOrchestrationApi — sole external REST surface, minimal controller, maps to OrchestratorService gRPC
MCP Actuators (3-pillar: Tools + Resources + Prompts):
Mcp.FileSystem — TYPE 1 write + TYPE 2 read, full LocalFileSystemService, path sandboxingMcp.Playwright — browser automation, snapshot_page, browser_click, browser_typeMcp.Git — git read (TYPE 2) + write (TYPE 1) operations
Shared Libraries:
CompanyName.ProjectName.Core — domain entities, EF DbContext, trail recordsCompanyName.ProjectName.AI — SovereignInference, SovereignSkillsProviderCompanyName.ProjectName.ServiceDefaults — OpenTelemetry, health checks, service discovery
Laws (Never Violate)
- NEVER add
Version= to any <PackageReference> — all versions in Directory.Packages.props
- NEVER hardcode CompanyName or ProjectName — template tokens replace everything
- NEVER add gRPC to an MCP project — MCPs are actuators, not phase agents
- NEVER add Microsoft.Agents.AI to an MCP project
- ALWAYS include SKILL.md in every project with
I AM declaration
- ALWAYS use
WithToolsFromAssembly() / WithResourcesFromAssembly() / WithPromptsFromAssembly()
- ALWAYS classify MCP tools as TYPE 1 (Orchestrator-only write) or TYPE 2 (any cognitive service read)
- ALWAYS use
Stateless = true on HTTP MCP transport
1---2name: pmcro-project-generator3description: Generates a complete, production-ready PMCR-O Cognitive Architecture .NET 10 Aspire project as a downloadable ZIP file. The generated project follows the real PMCRO substrate pattern: Aspire AppHost, gRPC-internal / REST-external hybrid, Microsoft Agent Framework (MAF) phase services (Planner, Maker, Checker, Reflector, OrchestratorService, OrchestrationApi), MCP actuators with three pillars (Tools + Resources + Prompts), Central Package Management, Directory.Build.props/targets, SKILL.md per service, and SeedIntent injection. Use this skill whenever a user provides a CompanyName, ProjectName, and SeedIntent and wants to scaffold a full PMCRO project. Triggers on: "generate PMCRO project", "scaffold cognitive architecture", "new PMCRO project", "generate project zip", "dotnet new pmcro", or any combination of intent + project name implying a PMCRO scaffold is desired.4---5
6# PMCRO Cognitive Architecture Project Generator v2
7
8Generates a **complete, production-ready** .NET 10 Aspire PMCRO project from three parameters.
9
10## Input Contract
11
12| Parameter | Example | Description |
13|-----------|---------|-------------|
14| `CompanyName` | `Tooensure` | PascalCase company — becomes namespace root + folder prefix |
15| `ProjectName` | `CogArch` | PascalCase project — combined as `CompanyName.ProjectName` everywhere |
16| `SeedIntent` | `"Develop PMCR-O Cognitive Architecture"` | Injected into InitFrame, TRAIN-000, SKILL.md files, Directory.Build.props |
17
18If any are missing, ask before generating.
19
20---
21
22## Generation Workflow
23
241. Confirm all three parameters.
252. Run `scripts/generate_project.py --company X --name Y --intent Z --output /path/`
263. Script produces `CompanyName.ProjectName.zip`.
274. Present the ZIP via `present_files`.
28
29```bash
30python3 /path/to/pmcro-v2/scripts/generate_project.py \
31 --company "CompanyName" \
32 --name "ProjectName" \
33 --intent "SeedIntent" \
34 --output /mnt/user-data/outputs/
35```
36
37---
38
39## What Gets Generated
40
41See `references/project-structure.md` for the complete file tree.
42
43### Architecture
44
45```
46External REST (HTTP)
47 │
48 ▼
49OrchestrationApi (:8080)
50 │
51 │ gRPC (internal)
52 ▼
53OrchestratorService (:7075)
54 │ │ │ │
55 │ │ │ └─► ReflectorService (:7074) [gRPC]
56 │ │ └──────► CheckerService (:7073) [gRPC]
57 │ └───────────► MakerService (:7072) [gRPC]
58 └────────────────► PlannerService (:7071) [gRPC]
59 │
60 MCP Actuators (HTTP)
61 ├── Mcp.FileSystem (:7221)
62 ├── Mcp.Playwright (:7273)
63 └── Mcp.Git (:7222)
64```
65
66### Key Pillars
67
68**Infrastructure:**
69- `Directory.Build.props` — net10.0, C# latest, ArtifactsPath, SeedIntent MSBuild property
70- `Directory.Build.targets` — SKILL.md → output copy + VerifyPmcroIdentity target
71- `Directory.Packages.props` — Central Package Management (ALL versions, no Version= in csproj)
72- `.template.config/template.json` — `dotnet new pmcro -company X -name Y -intent Z`
73
74**AppHost (Aspire):**
75- All services + MCPs registered with named endpoints
76- WaitFor chains: phase agents wait for MCPs; Orchestrator waits for all phases; Api waits for Orchestrator
77- `WithEnvironment("SeedIntent", ...)` injected into every service
78
79**Phase Services (gRPC internal, MAF):**
80- `CompanyName.ProjectName.Contracts` — shared `.proto` files + generated stubs
81- `PlannerService`, `MakerService`, `CheckerService`, `ReflectorService` — each with SKILL.md + gRPC impl
82- `OrchestratorService` — governs the loop, issues EXTEND/ACCEPT/ESCALATE/LOOP/INTERRUPT verdicts
83- `OrchestrationApi` — sole external REST surface, minimal controller, maps to OrchestratorService gRPC
84
85**MCP Actuators (3-pillar: Tools + Resources + Prompts):**
86- `Mcp.FileSystem` — TYPE 1 write + TYPE 2 read, full `LocalFileSystemService`, path sandboxing
87- `Mcp.Playwright` — browser automation, `snapshot_page`, `browser_click`, `browser_type`
88- `Mcp.Git` — git read (TYPE 2) + write (TYPE 1) operations
89
90**Shared Libraries:**
91- `CompanyName.ProjectName.Core` — domain entities, EF DbContext, trail records
92- `CompanyName.ProjectName.AI` — `SovereignInference`, `SovereignSkillsProvider`
93- `CompanyName.ProjectName.ServiceDefaults` — OpenTelemetry, health checks, service discovery
94
95---
96
97## Laws (Never Violate)
98
99- NEVER add `Version=` to any `<PackageReference>` — all versions in `Directory.Packages.props`
100- NEVER hardcode CompanyName or ProjectName — template tokens replace everything
101- NEVER add gRPC to an MCP project — MCPs are actuators, not phase agents
102- NEVER add Microsoft.Agents.AI to an MCP project
103- ALWAYS include SKILL.md in every project with `I AM` declaration
104- ALWAYS use `WithToolsFromAssembly()` / `WithResourcesFromAssembly()` / `WithPromptsFromAssembly()`
105- ALWAYS classify MCP tools as TYPE 1 (Orchestrator-only write) or TYPE 2 (any cognitive service read)
106- ALWAYS use `Stateless = true` on HTTP MCP transport
aibot88