pm-template/README.md

# Reltio PM Factory

A CLI-agnostic AI workspace for Product Managers. Pre-loaded with Transparent Factory standards, BMad Creative Suite, Jira/Aha!/Gainsight integrations, and epic-writing skills.

---

## Quick Start

### Docker (recommended)
```bash
git clone <this-repo> pm-template
cd pm-template
cp env.example .env   # fill in your API keys
docker compose up -d
```
Open http://localhost:3000.

### Local (no Docker)
```bash
git clone <this-repo> pm-template
cd pm-template
./start.sh
```

### Open WebUI
Use the drop-in artifacts in `openwebui/` to connect any Open WebUI instance.
See [`openwebui/SETUP.md`](openwebui/SETUP.md).

### Any CLI Agent
Open the repo in Cursor, Claude Code, Kiro, Codex, or Gemini CLI. They all read `AGENTS.md`.

---

## One-Time Setup

1. **Jira** — Run `mcporter auth atlassian` once to complete OAuth.
2. **API Keys** — Edit `.env` with your Aha! and Gainsight PX credentials.

---

## What's Inside

| Component | Purpose |
|-----------|---------|
| `docs/reltio-forge.md` | **Reltio Forge** — velocity layer for AI-accelerated delivery |
| `web/` | Forge Console — local chat UI (Express + WebSocket → Codex) |
| `openwebui/` | Open WebUI preset, pipelines, and knowledge manifest |
| `skills/` | Epics, Factory Standards, BMad Creative Suite, Gainsight PX |
| `config/mcporter.json` | MCP server definitions (Jira, Aha!, Context7) |

### Transparent Factory + Reltio Forge

**Transparent Factory** defines the 5 architectural tenets (Atomic Flagging, Elastic Schema, Cognitive Durability, Semantic Observability, Configurable Autonomy). **Reltio Forge** wraps each tenet in automated CI/CD enforcement — AI code review, formal verification, fail-fast gates, and configurable risk posture. See [`docs/reltio-forge.md`](docs/reltio-forge.md).

---

## Architecture

```
┌─────────────────────────────────────────┐
│  Frontend (pick one)                    │
│  • Forge Console (web/)                 │
│  • Open WebUI (openwebui/)              │
│  • CLI Agent (Codex, Claude, Kiro...)   │
└──────────────┬──────────────────────────┘
               ↕
┌──────────────┴──────────────────────────┐
│  LLM (any OpenAI-compatible provider)   │
│  + System Prompt (AGENTS.md)            │
│  + RAG Knowledge (skills/, standards/)  │
│  + Tool Pipelines (mcporter, aha, etc.) │
└──────────────┬──────────────────────────┘
               ↕ MCP
       Jira · Aha! · Gainsight PX
```