greenfield

$npx mdskill add wednesday-solutions/ai-agent-skills/greenfield

Plans new projects by running parallel persona agents and synthesizing results.

  • Solves the problem of creating comprehensive project plans from a brief.
  • Depends on reading BRIEF.md and generating research.md via a research agent.
  • Decides by running Architect, PM, and Security agents in parallel after research.
  • Delivers a detailed PLAN.md with a Tensions section via a synthesis agent.

SKILL.md

.github/skills/greenfieldView on GitHub ↗
---
name: greenfield
description: Parallel persona planning for new projects. Research agent runs first to build domain context, then Architect, PM, and Security agents run in parallel. Synthesis agent combines all perspectives into a detailed GSD-style PLAN.md with Tensions section.
license: MIT
metadata:
  author: wednesday-solutions
  version: "2.0"
---

# Greenfield Planning Skill

## Trigger

Run once per project: `ws-skills plan`

Reads `BRIEF.md` from the project root (or prompts for one). Asks 5 clarifying questions before planning.

## Flow

```
Brief + Q&A
    ↓
Research agent (sequential)   ← domain landscape, ecosystem, hidden complexity
    ↓
┌─────────────────────────────────────┐
│ Architect │ PM │ Security (parallel)│  ← spawn 3 subagents simultaneously
└─────────────────────────────────────┘
    ↓
Synthesis             ← combines all into PLAN.md
```

## Agents

### 1. Research (sequential — runs first)

Builds domain context that all other agents receive. Covers:
- Existing solutions and their weaknesses
- Standard and emerging tech stacks for this domain
- Technologies to avoid and why
- Non-obvious domain challenges
- Integration landscape (auth, payments, comms, etc.)
- Regulatory and compliance context
- Realistic timeline based on similar projects
- Hidden complexity — things that take 3x longer than expected
- Success patterns from the best products in this space

Output: `research.md`

### 2–4. Architect, PM, Security (parallel subagents)

Spawn all three simultaneously using the Agent tool. Each receives the full brief, Q&A, and research output as context.

```
Agent 1 — Architect
Agent 2 — PM           ← launch all three in a single message, do not wait
Agent 3 — Security
```

Wait for all three to complete before running Synthesis.

**Architect** output: `architect.md`
- System design overview
- Tech stack with rationale per layer
- Module boundaries and interfaces
- Infrastructure and CI/CD
- Scaling strategy
- Technical risks

**PM** output: `pm.md`
- Phases with tasks and acceptance criteria
- Success metrics
- Out of scope items
- Assumptions

**Security** output: `security.md`
- Threat model (likelihood + impact)
- Data classification
- Auth strategy recommendation
- Compliance flags
- Concrete security tasks
- Urgent flags

### 5. Synthesis

Combines research + all three persona outputs into a single PLAN.md covering:
- Overview
- Clarifications table
- Tech stack
- Architecture
- Phases with tasks and acceptance criteria
- Security plan
- Success metrics
- Risks
- Tensions (unresolved disagreements between personas)
- Assumptions
- Out of scope
- Branch naming (GIT-OS format)

Output: `PLAN.md`

## Tools

| Action | Tool |
|--------|------|
| Read `BRIEF.md` | `Read` |
| Write persona output files (`architect.md`, `pm.md`, etc.) | `Write` |
| Spawn Architect, PM, Security personas in parallel | `Agent` (3 calls in one message) |
| Search the brief for keywords | `Grep` |

## Output Location

All files written to `.wednesday/plans/` in the target directory:

```
.wednesday/plans/
├── research.md    ← domain context
├── architect.md   ← technical design
├── pm.md          ← phases and metrics
├── security.md    ← threat model
└── PLAN.md        ← combined PRD (primary output)
```

## Failure Handling

Each agent fails independently. If one fails, the others continue and synthesis runs with whatever data is available. Failed agents show `[partial fallback]` in the progress display.

## Rules

- Branch naming in PLAN.md must follow GIT-OS format
- Never generate `CODEBASE.md` for greenfield projects — it doesn't exist yet
- Cost target: under $0.20 per run

More from wednesday-solutions/ai-agent-skills

SkillDescription
brownfield-driftEnforces architecture boundaries defined in PLAN.md. Use when a PR crosses module/service boundaries, when the dev asks "are we following the architecture?", or as a scheduled architecture health check. Not for querying what a module does — use brownfield-chat for that.
codebase-intelUnified codebase intelligence. Handles all questions about structure, logic, risk, and dependencies. Combines natural-language Q&A with deterministic lookups and pre-edit blast radius checks.
deploy-checklistPre-deploy and post-deploy checklist skill. Ensures env vars, migrations, CI, rollback plan, smoke tests, and monitoring are verified before and after every deployment.
module-audit-agentUse when asked to audit a module, check its health, or assess whether it should be refactored. Runs structural query, risk check, and test generation automatically.
onboard-dev-agentUse when a dev is new to the project, asks for an overview, or wants to get oriented quickly. Fills graph gaps then runs a guided codebase interview.
pr-review-agentFull PR review orchestrator. Use when asked to review a PR or check if it is ready to merge. Runs blast radius + drift check on changed files, then hands off to pr-review for comment triage and fixes. Do NOT use pr-review directly for full reviews — use this.
standards-kitUnified development and design standards. Enforces code quality (complexity < 8), strict naming conventions, and the mandatory use of approved UI component libraries.
wednesday-gitUnified Git workflow. Manages the entire task lifecycle: branch creation (sprint), atomic commits (git-os), and PR opening (pr-create).