@radenadri/skills-alena 1.0.0 → 1.2.0

package/CLAUDE.md

@@ -96,6 +96,8 @@ Slash commands are available in `commands/`. Key commands:
 | `/debug` | Systematic debugging with root cause analysis |
 | `/deep-audit` | Brutal 5-pass exhaustive audit |
 | `/discuss` | Lock user preferences BEFORE planning — prevents rework |
+| `/lmf` | Run the learning-first tutorial flow before or alongside execution |
+| `/prd` | Create a product requirements document through an interview-first flow |
 | `/plan` | Create executable prompt plans with task anatomy |
 | `/execute` | Execute plans with deviation protocol and checkpoints |
 | `/settings` | View/modify project config (mode, depth, preferences) |
@@ -168,8 +170,10 @@ alena/
 │   ├── investigator.md
 │   └── fixer.md
 ├── cursor-rules/          ← Cursor IDE rules (10 rules)
-└── skills/                ← Composable skill library (30 skills)
+└── skills/                ← Composable skill library (32 skills)
     ├── brainstorming/
+    ├── lmf/
+    ├── write-prd/
     ├── writing-plans/
     ├── executing-plans/
     ├── test-driven-development/

package/GEMINI.md

@@ -93,6 +93,8 @@ Slash commands are available in `commands/`. Key commands:
 | `/debug` | Systematic debugging with root cause analysis |
 | `/deep-audit` | Brutal 5-pass exhaustive audit |
 | `/discuss` | Lock user preferences BEFORE planning — prevents rework |
+| `/lmf` | Run the learning-first tutorial flow before or alongside execution |
+| `/prd` | Create a product requirements document through an interview-first flow |
 | `/plan` | Create executable prompt plans with task anatomy |
 | `/execute` | Execute plans with deviation protocol and checkpoints |
 | `/settings` | View/modify project config (mode, depth, preferences) |
@@ -159,8 +161,10 @@ alena/
 │   ├── investigator.md
 │   └── fixer.md
 ├── cursor-rules/          ← Cursor IDE rules (10 rules)
-└── skills/                ← Composable skill library (30 skills)
+└── skills/                ← Composable skill library (32 skills)
     ├── brainstorming/
+    ├── lmf/
+    ├── write-prd/
     ├── writing-plans/
     ├── executing-plans/
     ├── test-driven-development/
@@ -196,6 +200,9 @@ alena/
 
 Workflows are installed in `.agent/workflows/`. Use `/workflow-name` to execute them. Workflows with `// turbo` annotations auto-run safe steps.
 
+Use `/lmf` when you want tutorial-first explanation and planning guidance before switching to direct execution.
+Use `/prd` when you want an interview-first product requirements document before implementation planning.
+
 ## Persistent Memory
 
 If `.planning/MEMORY.md` exists, read it at session start and update it at session end. This provides cross-session context. Use `node planning-tools.cjs` for deterministic state updates.

package/README.md

@@ -1,14 +1,13 @@
 <p align="center">
   <h1 align="center">🧠 ALENA (Autonomous Layer for Executing Networked Agents)</h1>
   <p align="center">
-    <strong>A personal toolkit for autonomous, networked AI agents — 33 skills · 34 commands · 37 workflows · 9 agents · 10 cursor rules · 8 hooks · 13 modules · 11 templates</strong>
+    <strong>A personal toolkit for autonomous, networked AI agents — 35 skills · 36 commands · 39 workflows · 9 agents · 10 cursor rules · 8 hooks · 13 modules · 11 templates</strong>
   </p>
   <p align="center">
     Make your AI coding assistant operate like your own disciplined toolkit.
   </p>
   <p align="center">
     <a href="#-quick-start"><img src="https://img.shields.io/badge/Get_Started-blue?style=for-the-badge" alt="Get Started"></a>
-    <a href="https://alena.radenadri.xyz"><img src="https://img.shields.io/badge/Website-7c3aed?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Website"></a>
     <a href="https://www.npmjs.com/package/@radenadri/skills-alena"><img src="https://img.shields.io/npm/v/%40radenadri%2Fskills-alena?style=for-the-badge&color=red" alt="NPM Version"></a>
     <a href="https://github.com/radenadri/skills-alena/blob/main/LICENSE"><img src="https://img.shields.io/github/license/radenadri/skills-alena?style=for-the-badge" alt="License"></a>
     <a href="https://github.com/radenadri/skills-alena/stargazers"><img src="https://img.shields.io/github/stars/radenadri/skills-alena?style=for-the-badge&color=gold" alt="Stars"></a>
@@ -16,7 +15,6 @@
   <p align="center">
     <a href="https://github.com/radenadri"><img src="https://img.shields.io/badge/GitHub-radenadri-181717?style=flat-square&logo=github" alt="GitHub"></a>
     <a href="https://github.com/radenadri/skills-alena/wiki"><img src="https://img.shields.io/badge/Wiki-Documentation-0969da?style=flat-square&logo=github" alt="Wiki"></a>
-    <a href="https://alena.radenadri.xyz"><img src="https://img.shields.io/badge/Homepage-alena.radenadri.xyz-0f766e?style=flat-square" alt="Homepage"></a>
   </p>
 </p>
 
@@ -26,6 +24,16 @@
 
 **ALENA** is a personal toolkit for autonomous, networked AI agents. The long form is **Autonomous Layer for Executing Networked Agents**. Install once, use everywhere — across **34+ supported agents** including Antigravity, Cursor, Claude Code, Gemini CLI, Windsurf, Copilot, and more.
 
+### 📄 PRD Creation Flow
+
+ALENA now ships a local PRD creation path for teams that want product clarification before implementation. The flow is built around:
+
+- a wrapper skill at `skills/write-prd/`
+- a Claude Code command at `commands/prd.md`
+- an Antigravity workflow at `workflows/prd.md`
+
+`write-prd` is not the same as `writing-plans`. `write-prd` is interview-first and product-first: it clarifies the user, problem, goals, non-goals, and success definition before drafting a reusable product requirements document. `writing-plans` starts after that, when the approved PRD needs to turn into implementation work.
+
 ---
 
 ### 💎 The Gem: LLM Council v2 + Memory Module
@@ -38,9 +46,9 @@
 
 ```
                     ╔═══════════════════════════════╗
-                    ║     🎯 ORCHESTRATOR (lean)      ║
-                    ║  13 CLI commands · Quality gates  ║
-                    ║  ~10-15% context · Task() spawn   ║
+                    ║     🎯 ORCHESTRATOR (lean)     ║
+                    ║  13 CLI commands · Quality gates ║
+                    ║  ~10-15% context · Task() spawn  ║
                     ╚════════════╦══════════════════╝
                                  ║
                         Task() spawning
@@ -64,10 +72,18 @@
 
 ## 🔄 Version History
 
-### 🏆 1.0.0 — Initial ALENA Release
+### 1.2.0 — Add `/prd` command
+
+- Add `write-prd` skill. Add `/prd` command for Claude Code and Antigravity.
+
+### 1.1.0 — Add `/lmf` command
+
+- Add `lmf` skills. Add `/lmf` command for Claude Code and Antigravity. 
+
+### 1.0.0 — Initial ALENA Release
 
 - 🧠 **ALENA identity and public release reset** — the toolkit starts at `v1.0.0` with ALENA branding, updated install commands, refreshed docs, and release surfaces aligned under the new package and repository.
-- 🤖 **Full asset library included** — ships with **33 skills**, **34 commands**, **37 workflows**, and **9 specialist agents** covering brainstorming, planning, execution, debugging, auditing, review, verification, memory, and team coordination.
+- 🤖 **Full asset library included** — ships with **35 skills**, **36 commands**, **39 workflows**, and **9 specialist agents** covering brainstorming, planning, PRD creation, execution, debugging, auditing, review, verification, memory, and team coordination.
 - ⚙️ **Deterministic planning core** — `planning-tools.cjs` plus **12 supporting CLI modules** handle state, phase, roadmap, verification, frontmatter, config, templates, milestones, model resolution, and council coordination without relying on brittle freeform markdown edits.
 - 🏛️ **Council system built in** — real subagent spawning, structured handoffs, code-enforced quality gates, task boards, and 6 presets (`full`, `rapid`, `debug`, `architecture`, `refactoring`, `audit`) are included in the first release.
 - 🪝 **Hook and session tooling** — includes **8 hooks** for statusline, update checks, context monitoring, memory capture, cost tracking, and related session behavior where the target runtime supports them.
@@ -293,81 +309,83 @@ ALENA works with **30+ AI coding agents**. **12 platforms have full asset parity
 
 ## 📚 Complete Asset Catalog
 
-### 🧠 Skills (32)
+### 🧠 Skills (35)
 
 Skills are deep instructional documents that teach AI agents HOW to think about specific engineering tasks. Each skill contains principles, protocols, anti-patterns, and quality criteria.
 
-#### 🔷 Core Development (8 skills)
+#### 🔷 Core Development (10 skills)
 
 | # | Skill | Description |
 |:---:|:---|:---|
 | 1 | 💡 **brainstorming** | Creative ideation — mind maps, structured exploration, and divergent thinking before any feature work |
-| 2 | 📝 **writing-plans** | Task decomposition — dependency-aware plans with effort estimates, risk assessments, and implementation waves |
-| 3 | ⚙️ **executing-plans** | Plan execution — wave-based implementation with checkpoints, inline verification, and state tracking |
-| 4 | 🧪 **test-driven-development** | TDD methodology — red-green-refactor cycle, test architecture, fixture patterns, and coverage strategies |
-| 5 | 🐛 **systematic-debugging** | Scientific debugging — hypothesis-driven investigation with evidence chains and root cause analysis |
-| 6 | 🔍 **code-review** | Structured code review — security, performance, correctness checks with severity-based feedback |
-| 7 | ✅ **verification-before-completion** | Completion gates — automated checks, compliance verification, and regression testing before marking done |
-| 8 | 📦 **git-workflow** | Git best practices — conventional commits, branching strategies, PR workflows, and conflict resolution |
+| 2 | 📄 **write-prd** | Product requirements writing — interview-first wrapper skill that turns feature ideas into structured PRDs before engineering planning — ✨ NEW |
+| 3 | 🧭 **lmf** | Learning-first mode flow — wrapper skill that combines `brainstorming`, `writing-plans`, and `writing-documentation` into a tutorial-first orchestration pattern — ✨ NEW |
+| 4 | 📝 **writing-plans** | Task decomposition — dependency-aware plans with effort estimates, risk assessments, and implementation waves |
+| 5 | ⚙️ **executing-plans** | Plan execution — wave-based implementation with checkpoints, inline verification, and state tracking |
+| 6 | 🧪 **test-driven-development** | TDD methodology — red-green-refactor cycle, test architecture, fixture patterns, and coverage strategies |
+| 7 | 🐛 **systematic-debugging** | Scientific debugging — hypothesis-driven investigation with evidence chains and root cause analysis |
+| 8 | 🔍 **code-review** | Structured code review — security, performance, correctness checks with severity-based feedback |
+| 9 | ✅ **verification-before-completion** | Completion gates — automated checks, compliance verification, and regression testing before marking done |
+| 10 | 📦 **git-workflow** | Git best practices — conventional commits, branching strategies, PR workflows, and conflict resolution |
 
 #### 🔶 Auditing (10 skills)
 
 | # | Skill | Description |
 |:---:|:---|:---|
-| 9 | 🏛️ **architecture-audit** | Architecture review — modularity, coupling, SOLID compliance, dependency direction, and scalability assessment |
-| 10 | 🔒 **security-audit** | Security assessment — OWASP top 10, auth flows, input validation, secrets management, and vulnerability scanning |
-| 11 | ⚡ **performance-audit** | Performance profiling — N+1 queries, bundle sizes, runtime bottlenecks, caching opportunities, and load testing |
-| 12 | 🗄️ **database-audit** | Database health — schema design, indexing strategy, query optimization, migrations, and normalization review |
-| 13 | 🎨 **frontend-audit** | Frontend quality — component architecture, state management, rendering efficiency, and responsive design |
-| 14 | 🌐 **api-design-audit** | API design review — REST/GraphQL conventions, versioning, error handling, pagination, and documentation |
-| 15 | 📦 **dependency-audit** | Dependency health — outdated packages, security vulnerabilities, license compliance, and bundle impact |
-| 16 | 📊 **observability-audit** | Observability review — logging strategy, metrics, tracing, alerting, and production debugging capability |
-| 17 | ♿ **accessibility-audit** | Accessibility compliance — WCAG standards, keyboard navigation, screen reader support, and color contrast |
-| 18 | 🔄 **ci-cd-audit** | CI/CD pipeline review — build times, test reliability, deployment safety, and pipeline optimization |
+| 11 | 🏛️ **architecture-audit** | Architecture review — modularity, coupling, SOLID compliance, dependency direction, and scalability assessment |
+| 12 | 🔒 **security-audit** | Security assessment — OWASP top 10, auth flows, input validation, secrets management, and vulnerability scanning |
+| 13 | ⚡ **performance-audit** | Performance profiling — N+1 queries, bundle sizes, runtime bottlenecks, caching opportunities, and load testing |
+| 14 | 🗄️ **database-audit** | Database health — schema design, indexing strategy, query optimization, migrations, and normalization review |
+| 15 | 🎨 **frontend-audit** | Frontend quality — component architecture, state management, rendering efficiency, and responsive design |
+| 16 | 🌐 **api-design-audit** | API design review — REST/GraphQL conventions, versioning, error handling, pagination, and documentation |
+| 17 | 📦 **dependency-audit** | Dependency health — outdated packages, security vulnerabilities, license compliance, and bundle impact |
+| 18 | 📊 **observability-audit** | Observability review — logging strategy, metrics, tracing, alerting, and production debugging capability |
+| 19 | ♿ **accessibility-audit** | Accessibility compliance — WCAG standards, keyboard navigation, screen reader support, and color contrast |
+| 20 | 🔄 **ci-cd-audit** | CI/CD pipeline review — build times, test reliability, deployment safety, and pipeline optimization |
 
 #### 🔷 Evolution (4 skills)
 
 | # | Skill | Description |
 |:---:|:---|:---|
-| 19 | ♻️ **refactoring-safely** | Safe refactoring — incremental transformation with test coverage, feature flags, and rollback strategies |
-| 20 | 📖 **writing-documentation** | Documentation authoring — API docs, architecture diagrams, README standards, and knowledge transfer |
-| 21 | 🗺️ **codebase-mapping** | Codebase analysis — module boundaries, dependency graphs, entry points, and health metrics |
-| 22 | 🚨 **incident-response** | Incident handling — triage protocols, root cause analysis, post-mortems, and prevention measures |
+| 21 | ♻️ **refactoring-safely** | Safe refactoring — incremental transformation with test coverage, feature flags, and rollback strategies |
+| 22 | 📖 **writing-documentation** | Documentation authoring — API docs, architecture diagrams, README standards, and knowledge transfer |
+| 23 | 🗺️ **codebase-mapping** | Codebase analysis — module boundaries, dependency graphs, entry points, and health metrics |
+| 24 | 🚨 **incident-response** | Incident handling — triage protocols, root cause analysis, post-mortems, and prevention measures |
 
-#### 🟣 Agent Intelligence (2 skills) — ✨ NEW in v3
+#### 🟣 Agent Intelligence (2 skills)
 
 | # | Skill | Description |
 |:---:|:---|:---|
-| 23 | 💾 **persistent-memory** | Automated session memory — captures decisions, context, and learnings across sessions via file-based protocols. Zero infrastructure, works in ANY agent. Inspired by [claude-mem](https://github.com/thedotmack/claude-mem). |
-| 24 | 💎 **agent-team-coordination** | **LLM Council** — Manager-orchestrated multi-agent coordination with Memory Module. Manager has full project knowledge (schemas, routes, services), dynamically routes tasks to specialist sub-agents, enables peer communication, handles escalations across 6 council presets. |
+| 25 | 💾 **persistent-memory** | Automated session memory — captures decisions, context, and learnings across sessions via file-based protocols. Zero infrastructure, works in ANY agent. Inspired by [claude-mem](https://github.com/thedotmack/claude-mem). |
+| 26 | 💎 **agent-team-coordination** | **LLM Council** — Manager-orchestrated multi-agent coordination with Memory Module. Manager has full project knowledge (schemas, routes, services), dynamically routes tasks to specialist sub-agents, enables peer communication, handles escalations across 6 council presets. |
 
-#### 🔶 Integration & Completeness (3 skills) — ✨ NEW
+#### 🔶 Integration & Completeness (4 skills)
 
 | # | Skill | Description |
 |:---:|:---|:---|
-| 25 | 🔗 **full-stack-api-integration** | End-to-end API integration — spec analysis, surface mapping, SOLID-compliant API layer design, systematic endpoint implementation, and integration testing |
-| 26 | 🏥 **product-completeness-audit** | Functional completeness verification — 5-level completeness spectrum, placeholder detection, broken flow identification, and API connection validation |
-| 27 | 🔬 **brutal-exhaustive-audit** | No-shortcuts 5-pass audit — build verification, route checking, data flow tracing, user flow testing, and edge case validation with anti-shortcut rules |
+| 27 | 🔗 **full-stack-api-integration** | End-to-end API integration — spec analysis, surface mapping, SOLID-compliant API layer design, systematic endpoint implementation, and integration testing |
+| 28 | 🏥 **product-completeness-audit** | Functional completeness verification — 5-level completeness spectrum, placeholder detection, broken flow identification, and API connection validation |
+| 29 | 🔬 **brutal-exhaustive-audit** | No-shortcuts 5-pass audit — build verification, route checking, data flow tracing, user flow testing, and edge case validation with anti-shortcut rules |
+| 30 | 🔄 **codebase-conformity** | Pattern uniformity enforcement — read existing patterns before writing, match them exactly, and double-verify conformity before claiming done |
 
 #### 🔀 Migration (1 skill)
 
 | # | Skill | Description |
 |:---:|:---|:---|
-| 28 | 🔀 **nextjs-to-nuxt-migration** | Next.js → Nuxt 4 migration — submodule analysis, backend verification, multi-pass execution (backend wiring → feature completeness → CSS polish → verification), sidebar registration, theme/dark-mode rules, URL encoding, Agent Team File Protocol, and Playwright visual QA |
+| 31 | 🔀 **nextjs-to-nuxt-migration** | Next.js → Nuxt 4 migration — submodule analysis, backend verification, multi-pass execution (backend wiring → feature completeness → CSS polish → verification), sidebar registration, theme/dark-mode rules, URL encoding, Agent Team File Protocol, and Playwright visual QA |
 
 #### 🔸 Meta (5 skills)
 
 | # | Skill | Description |
 |:---:|:---|:---|
-| 29 | 📘 **using-skills** | How to use and combine skills effectively in your workflow |
-| 30 | ✍️ **writing-skills** | How to create new skills — format, quality standards, and testing requirements |
-| 31 | 🔄 **codebase-conformity** | Pattern uniformity enforcement — read existing patterns before writing, match them exactly, double-verify conformity before claiming done |
-| 32 | 🎨 **ui-ux-redesign** | Full-stack visual audit — inventories backend APIs, audits every component and design token, analyzes user flows, and produces layered redesign recommendations |
-| 33 | 📏 **_rules** | Master rules skill — consolidates core principles, anti-hallucination protocol, severity framework, and skill activation table |
+| 32 | 📘 **using-skills** | How to use and combine skills effectively in your workflow |
+| 33 | ✍️ **writing-skills** | How to create new skills — format, quality standards, and testing requirements |
+| 34 | 🎨 **ui-ux-redesign** | Full-stack visual audit — inventories backend APIs, audits every component and design token, analyzes user flows, and produces layered redesign recommendations |
+| 35 | 📏 **_rules** | Master rules skill — consolidates core principles, anti-hallucination protocol, severity framework, and skill activation table |
 
 ---
 
-### ⚡ Commands (34)
+### ⚡ Commands (36)
 
 Commands are Claude Code slash commands (`.md` files installed to `.claude/commands/`). They provide structured workflows for common project tasks.
 
@@ -376,12 +394,14 @@ Commands are Claude Code slash commands (`.md` files installed to `.claude/comma
 | Command | Description |
 |:---|:---|
 | `/init-project` | 🏗️ Initialize a new project with `.planning/` directory — `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`, `config.json`. Uses `planning-tools.cjs` for deterministic bootstrapping. |
-| `/discuss` | 💬 Pre-planning MCQ decision capture — presents multiple-choice questions with recommendations, quick-answer format (`1A 2B 3C`), locks decisions in CONTEXT.md — ✨ NEW |
+| `/discuss` | 💬 Pre-planning MCQ decision capture — presents multiple-choice questions with recommendations, quick-answer format (`1A 2B 3C`), locks decisions in CONTEXT.md |
+| `/prd` | 📄 Product requirements drafting — interview-first flow that uses the local `write-prd` wrapper skill to produce a reusable PRD before implementation planning — ✨ NEW |
+| `/lmf` | 🧭 Learning-first tutorial flow — uses the local `lmf` wrapper skill to combine explanation, planning, and documentation-style guidance before execution — ✨ NEW |
 | `/plan` | 📋 Create a 2-3 task implementation plan with task anatomy (`<files>` `<action>` `<verify>` `<done>`), context budgets, and locked decision enforcement |
 | `/execute` | ⚙️ Execute an implementation plan with deviation protocol (4 categories), checkpoint system, and `planning-tools.cjs` state management |
 | `/verify` | ✅ Validate implementations against plans — automated checks, compliance verification, regression testing, conversational UAT |
 | `/progress` | 📊 Display project progress, phase status, and task completion from `.planning/` state files |
-| `/settings` | ⚙️ View/modify project config — mode (interactive/auto), depth (quick/standard/comprehensive), workflow preferences — ✨ NEW |
+| `/settings` | ⚙️ View/modify project config — mode (interactive/auto), depth (quick/standard/comprehensive), workflow preferences |
 
 #### 🔷 Research & Documentation
 
@@ -418,14 +438,14 @@ Commands are Claude Code slash commands (`.md` files installed to `.claude/comma
 | `/quick` | ⚡ Execute small, well-defined tasks without full project planning |
 | `/commit` | 📦 Create well-formatted Conventional Commits with proper scope and body |
 
-#### 🟣 Agent Intelligence — ✨ NEW in v3
+#### 🟣 Agent Intelligence
 
 | Command | Description |
 |:---|:---|
 | `/memory` | 💾 Persistent memory management — `init`, `read`, `write`, `compress`, `status` operations |
 | `/team` | 🤝 Multi-role team coordination — `start`, `resume`, `next`, `board`, `status` operations |
 
-#### 🔶 Integration & Auditing — ✨ NEW
+#### 🔶 Integration & Auditing
 
 | Command | Description |
 |:---|:---|
@@ -447,14 +467,16 @@ Commands are Claude Code slash commands (`.md` files installed to `.claude/comma
 
 ---
 
-### 🔄 Workflows (37)
+### 🔄 Workflows (39)
 
 Workflows are Antigravity step-by-step execution scripts (`.md` files installed to `.agent/workflows/`). Many include `// turbo` annotations for auto-execution.
 
 | Workflow | Description |
 |:---|:---|
 | `/init-project` | 🏗️ Initialize project with `.planning/` structure |
-| `/discuss` | 💬 Pre-planning MCQ discussion with quick-answer —  ✨ NEW |
+| `/discuss` | 💬 Pre-planning MCQ discussion with quick-answer |
+| `/prd` | 📄 Product requirements workflow that mirrors the local `write-prd` wrapper skill in Antigravity — ✨ NEW |
+| `/lmf` | 🧭 Learning-first tutorial workflow that mirrors the local `lmf` wrapper skill in Antigravity — ✨ NEW |
 | `/plan-feature` | 📋 Plan a feature with research, design, and task decomposition |
 | `/execute` | ⚙️ Execute plans with wave-based steps and verification |
 | `/verify` | ✅ Validate implementation against plans |
@@ -478,13 +500,13 @@ Workflows are Antigravity step-by-step execution scripts (`.md` files installed
 | `/codebase-map` | 🗺️ Codebase analysis and mapping |
 | `/deps-update` | 📦 Dependency updates |
 | `/incident-response` | 🚨 Incident triage and response |
-| `/memory-sync` | 💾 Memory read/write/compress operations — ✨ NEW |
-| `/team-session` | 🤝 Multi-role team coordination — ✨ NEW |
-| `/integrate-api` | 🔗 Full-stack API integration workflow — ✨ NEW |
-| `/product-health-check` | 🏥 Product completeness audit workflow — ✨ NEW |
-| `/deep-audit` | 🔬 Brutal exhaustive audit workflow — ✨ NEW |
-| `/redesign` | 🎨 Full UI/UX redesign workflow — ✨ NEW |
-| `/gap-closure` | 🔧 Close execution gaps with focused mini-plans — ✨ NEW |
+| `/memory-sync` | 💾 Memory read/write/compress operations |
+| `/team-session` | 🤝 Multi-role team coordination |
+| `/integrate-api` | 🔗 Full-stack API integration workflow |
+| `/product-health-check` | 🏥 Product completeness audit workflow |
+| `/deep-audit` | 🔬 Brutal exhaustive audit workflow |
+| `/redesign` | 🎨 Full UI/UX redesign workflow |
+| `/gap-closure` | 🔧 Close execution gaps with focused mini-plans |
 
 ---
 
@@ -520,8 +542,8 @@ Cursor rules are `.mdc` files installed to `.cursor/rules/`. They guide Cursor A
 | 🗄️ **database** | Database rules — schema design, indexing, query optimization, migrations |
 | 🧪 **testing** | Testing standards — coverage requirements, fixture patterns, assertion quality |
 | 🔍 **code-review** | Code review checklist — automated and manual review criteria |
-| 💾 **memory-protocol** | Persistent memory — auto-read MEMORY.md on start, auto-write on end — ✨ NEW |
-| 🤝 **team-protocol** | Team coordination — sequential role-switching with blackboard — ✨ NEW |
+| 💾 **memory-protocol** | Persistent memory — auto-read MEMORY.md on start, auto-write on end |
+| 🤝 **team-protocol** | Team coordination — sequential role-switching with blackboard |
 
 ---
 
@@ -534,8 +556,8 @@ Universal rules (`.md` files) that can be appended to `GEMINI.md`, `CLAUDE.md`,
 | 🏗️ **core-principles** | Foundational engineering principles — SOLID, DRY, KISS, YAGNI, and clean architecture |
 | 🚫 **anti-hallucination** | Verification-first protocol — never fabricate APIs, paths, or configs |
 | ⚖️ **severity-framework** | Issue severity classification — critical/major/minor/nit with response criteria |
-| 💾 **memory-protocol** | Persistent memory instructions — auto-read and auto-write `.planning/MEMORY.md` — ✨ NEW |
-| 🤝 **team-protocol** | Team coordination instructions — role-switching and blackboard protocol — ✨ NEW |
+| 💾 **memory-protocol** | Persistent memory instructions — auto-read and auto-write `.planning/MEMORY.md` |
+| 🤝 **team-protocol** | Team coordination instructions — role-switching and blackboard protocol |
 
 ---
 
@@ -671,21 +693,21 @@ AI coding tasks fail at scale because no single agent can hold all context: data
 
 ```
 alena/
-├── 📂 skills/                   # 32 deep instructional skills
+├── 📂 skills/                   # 35 deep instructional skills
 │   ├── brainstorming/SKILL.md
 │   ├── writing-plans/SKILL.md          # Plans-as-prompts with task anatomy
 │   ├── executing-plans/SKILL.md        # Deviation protocol + checkpoints
 │   ├── persistent-memory/SKILL.md
 │   ├── agent-team-coordination/SKILL.md
 │   └── ... (26 more)
-├── 📂 commands/                 # 34 Claude Code slash commands
+├── 📂 commands/                 # 36 Claude Code slash commands
 │   ├── init-project.md
 │   ├── discuss.md                       ✨ MCQ decision capture
 │   ├── settings.md                      ✨ Config management
 │   ├── memory.md
 │   ├── team.md
 │   └── ... (23 more)
-├── 📂 workflows/                # 37 Antigravity workflows
+├── 📂 workflows/                # 39 Antigravity workflows
 │   ├── init-project.md
 │   ├── discuss.md                       ✨ MCQ discussion workflow
 │   ├── gap-closure.md                   ✨ Execution gap closure
@@ -737,6 +759,8 @@ npx @radenadri/skills-alena add --global
 
 # Install specific skills
 npx @radenadri/skills-alena add persistent-memory code-review
+npx @radenadri/skills-alena add lmf brainstorming writing-plans writing-documentation
+npx @radenadri/skills-alena add write-prd brainstorming writing-documentation
 
 # Update all skills to latest version
 npx @radenadri/skills-alena update
@@ -780,6 +804,8 @@ npx @radenadri/skills-alena help
 | **GEMINI.md** | Appends activation section (preserves your content). Updates on re-install. | ❌ Skipped |
 | **Memory** | Never installed (created at runtime per-project). | ❌ Never installed |
 
+If you want the full local experience, install locally so wrapper skills can be paired with their agent-specific surfaces. That applies to both `lmf` and PRD drafting: global install includes the `lmf` and `write-prd` skills, but the Claude Code `/lmf` and `/prd` commands plus the Antigravity `/lmf` and `/prd` workflows are local-only surfaces.
+
 ### What Gets Installed Where
 
 | Asset Type | Claude Code | Cursor | Antigravity |
@@ -798,9 +824,15 @@ npx @radenadri/skills-alena help
 |:---|:---|
 | [🌐 Website](https://alena.radenadri.xyz) | Product homepage and primary landing page |
 | [📖 Wiki](https://github.com/radenadri/skills-alena/wiki) | Comprehensive GitHub Wiki with guides and reference |
+| [`skills/write-prd/SKILL.md`](skills/write-prd/SKILL.md) | Local wrapper skill for interview-first PRD creation |
+| [`commands/prd.md`](commands/prd.md) | Claude Code `/prd` product requirements command |
+| [`workflows/prd.md`](workflows/prd.md) | Antigravity `/prd` product requirements workflow |
+| [`skills/lmf/SKILL.md`](skills/lmf/SKILL.md) | Local wrapper skill for the `lmf` orchestrator pattern |
+| [`commands/lmf.md`](commands/lmf.md) | Claude Code `/lmf` learning-first command |
+| [`workflows/lmf.md`](workflows/lmf.md) | Antigravity `/lmf` learning-first workflow |
 | [Agent Teams & Memory](docs/AGENT-TEAMS-AND-MEMORY.md) | Comprehensive guide to the team coordination and persistent memory systems |
 | [Competitive Analysis](docs/COMPETITIVE_ANALYSIS.md) | Analysis of GSD, Claude Code, Cursor, and Antigravity frameworks |
-| [Audit Report](docs/AUDIT-REPORT.md) | Comprehensive 10/10 quality audit of all 29 skills |
+| [Audit Report](docs/AUDIT-REPORT.md) | Comprehensive quality audit report for the ALENA skill library |
 | [Contributing](CONTRIBUTING.md) | How to contribute to this project |
 | [Changelog](CHANGELOG.md) | Version history and release notes |
 
@@ -810,9 +842,9 @@ npx @radenadri/skills-alena help
 
 | Metric | Count |
 |:---:|:---:|
-| 🧠 Skills | **32** |
-| ⚡ Commands | **34** |
-| 🔄 Workflows | **37** |
+| 🧠 Skills | **35** |
+| ⚡ Commands | **36** |
+| 🔄 Workflows | **39** |
 | 🤖 Agents | **9** |
 | 🎯 Cursor Rules | **10** |
 | 📏 Rules | **5** |

package/commands/lmf.md

@@ -0,0 +1,36 @@
+---
+name: lmf
+description: "Run the learning-first /lmf flow for tutorial-style planning and explanation before execution."
+disable-model-invocation: true
+argument-hint: "[topic-or-task]"
+---
+
+# /lmf - Learning-First Tutorial Flow
+
+Guide the user through the request in a tutorial-first way using the local `lmf` wrapper skill.
+
+## Instructions
+
+1. Read `skills/lmf/SKILL.md` and follow it exactly.
+2. Use the request in `$ARGUMENTS` as the topic to explain, plan, or teach.
+3. Build the response around this order:
+   - What this actually is
+   - Mental model
+   - Recommended path
+   - Step-by-step actions
+   - Next move
+4. Compose the existing ALENA skills inside the response:
+   - `brainstorming` for intent and trade-offs
+   - `writing-plans` for the ordered implementation path
+   - `writing-documentation` for clarity and reuse
+5. Keep the output local-first and tutorial-first:
+   - Explain before optimizing
+   - Be specific to the current request and codebase
+   - Use small examples only when they reduce ambiguity
+   - Do not turn `/lmf` into a shell-script or helper-script instruction
+
+## Success Criteria
+
+- The user understands the problem shape before seeing the steps
+- The response contains a clear recommendation with trade-offs
+- The next action is explicit enough to execute immediately

package/commands/prd.md

@@ -0,0 +1,35 @@
+---
+name: prd
+description: "Create a product requirements document through an interview-first PRD workflow."
+disable-model-invocation: true
+argument-hint: "[feature-or-product-problem]"
+---
+
+# /prd - Product Requirements Document
+
+Create a structured PRD using the local `write-prd` wrapper skill.
+
+## Instructions
+
+1. Read `skills/write-prd/SKILL.md` and follow it exactly.
+2. Use `$ARGUMENTS` as the starting feature idea, product problem, or PRD topic.
+3. Interview before drafting:
+   - clarify the user
+   - clarify the problem
+   - clarify goals and non-goals
+   - clarify constraints, risks, and success definition
+4. Compose ALENA's underlying logic:
+   - `brainstorming` for discovery and trade-offs
+   - `writing-documentation` for the final PRD structure and clarity
+   - `writing-plans` only as a handoff suggestion after the PRD is accepted
+5. Keep the output product-first:
+   - write requirements as outcomes, not code tasks
+   - call out assumptions and open questions
+   - include explicit non-goals
+   - end with the next recommended step
+
+## Success Criteria
+
+- The PRD is grounded in an interview, not guesswork
+- The document is understandable without the full chat history
+- The output is a real product artifact, not an implementation checklist

package/dist/cli.js

@@ -287,6 +287,8 @@ var AGENTS = [
 var SKILL_CATEGORIES = {
   "Core Development": [
     "brainstorming",
+    "lmf",
+    "write-prd",
     "writing-plans",
     "executing-plans",
     "test-driven-development",
@@ -479,14 +481,15 @@ Skills activate automatically when their conditions are met. You MUST use the re
     content += `
 ### Workflows
 
-Workflows are installed in \`${agent.workflowsDir}/\`. Use \`/workflow-name\` to execute them. Workflows with \`// turbo\` annotations auto-run safe steps.
+Workflows are installed in \`${agent.workflowsDir}/\`. Use \`/workflow-name\` to execute them. Workflows with \`// turbo\` annotations auto-run safe steps. Use \`/lmf\` for learning-first tutorial and explanation flow.
+Workflows are installed in \`${agent.workflowsDir}/\`. Use \`/workflow-name\` to execute them. Workflows with \`// turbo\` annotations auto-run safe steps. Use \`/lmf\` for learning-first tutorial and explanation flow, and \`/prd\` for interview-first product requirements drafting.
 `;
   }
   if (hasCommands) {
     content += `
 ### Commands
 
-Slash commands are available in \`${agent.commandsDir}/\`. Key commands include: \`/audit\`, \`/debug\`, \`/plan\`, \`/execute\`, \`/verify\`, \`/commit\`, \`/team\`, \`/memory\`.
+Slash commands are available in \`${agent.commandsDir}/\`. Key commands include: \`/audit\`, \`/debug\`, \`/lmf\`, \`/prd\`, \`/plan\`, \`/execute\`, \`/verify\`, \`/commit\`, \`/team\`, \`/memory\`.
 `;
   }
   if (hasAgentDefs) {