pmcro-project-generator

name	pmcro-project-generator
description	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.
compatibility	.NET 10 | C# 14 | Aspire 13.x | MAF 1.0.0-rc2 | MCP 1.2.0 | gRPC | Docker

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

1. Confirm all three parameters.
2. Run scripts/generate_project.py --company X --name Y --intent Z --output /path/
3. Script produces CompanyName.ProjectName.zip.
4. 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 property
• Directory.Build.targets — SKILL.md → output copy + VerifyPmcroIdentity target
• Directory.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 stubs
• PlannerService, MakerService, CheckerService, ReflectorService — each with SKILL.md + gRPC impl
• OrchestratorService — governs the loop, issues EXTEND/ACCEPT/ESCALATE/LOOP/INTERRUPT verdicts
• OrchestrationApi — 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 sandboxing
• Mcp.Playwright — browser automation, snapshot_page, browser_click, browser_type
• Mcp.Git — git read (TYPE 2) + write (TYPE 1) operations

Shared Libraries:

• CompanyName.ProjectName.Core — domain entities, EF DbContext, trail records
• CompanyName.ProjectName.AI — SovereignInference, SovereignSkillsProvider
• CompanyName.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