Help / Green Codens

Green Codens setup

PRD / Plan / Kickoff management. Turn ambiguous requirements into a structured Consultation → PRD → Plan → Purple flow, with optional Notion sync.

Overview

Green Codens is the pipeline that turns vague requests into executable PRDs and Plans. The main units:

Consultation: natural-language chat that gathers context. Entry point for converting into a PRD, Kickoff, or Bug.
PRD: structured requirements document on a template. Has review / approve / archive lifecycle.
Plan: implementation breakdown derived from a PRD. Can be submitted to Purple for a PR.
Kickoff: stepwise interview (Vision → Scope → Tech → Milestones) for greenfield projects.

Prerequisites

A Codens account and organization.
codens-mcp installed and logged in.
For Notion integration: Notion workspace admin (OAuth link is required).
For Plan → Purple → PR automation: Purple Codens already configured.

Step 1. Create a project

Dashboard (app.green.codens.ai) → "New Project", or via MCP:

// Create a project
await tools.green_project({
  action: "create",
  name: "Billing Revamp 2026",
  description: "..."
});

// Link a GitHub repo (required for Plan → Purple submission)
await tools.green_repository({ action: "add", project_id, repo_full_name: "Corevice/billing" });

Step 2. Connect Notion (optional)

Two-way sync between PRDs / tasks and Notion. Recommended when discussions happen in Notion.

Check link status with green_notion({ action: "status" }).
If unlinked, run green_notion({ action: "link" }) and open the returned URL to authorize via Notion OAuth (workspace admin required).
Use green_project({ action: "setup_tasks_db_columns" }) to provision the required Tasks DB columns.

Renaming the Notion DB's status column or option labels can break sync. Re-running setup_tasks_db_columns reconciles it safely.

Step 3. First Consultation → PRD → Plan → Purple

// 1. Start a Consultation with an initial message
const c = await tools.green_consultation({
  action: "create_with_message",
  project_id: "...",
  title: "Annual plan selector UI",
  content: "Add an annual plan option to the billing screen..."
});

// 2. Convert to a PRD (pick a template)
const prd = await tools.green_consultation({
  action: "convert_to_prd",
  consultation_id: c.id,
  template_id: "..."
});

// 3. Generate a Plan from the PRD
const plan = await tools.green_plan({
  action: "generate_from_prd",
  prd_id: prd.id
});

// 4. Submit the Plan to Purple — full PR automation
await tools.green_plan({
  action: "submit_to_purple",
  plan_id: plan.id
});

PRD reviews (green_prd_review), comments (green_prd_comment), and translations (green_prd_translate) are available too.

Kickoff wizard (greenfield projects)

For new initiatives, the Kickoff wizard walks the team through Vision → Scope → Tech → Milestones and produces PRDs / UI mockups / a prototype in one go.

// Start from the Vision step
await tools.green_kickoff_wizard({
  action: "start_vision",
  project_id: "..."
});

// Once the steps are complete, generate everything
await tools.green_kickoff_generate({
  action: "generate_prds",
  kickoff_id: "..."
});
await tools.green_kickoff_generate({
  action: "generate_ui",
  kickoff_id: "..."
});
await tools.green_kickoff_generate({
  action: "generate_prototype",
  kickoff_id: "..."
});

Next steps

Green use case

Consultation → PRD → implementation

Purple chain

Destination for Plan submissions

Green tools (24)

Full action list