aped-method 1.0.0 → 1.6.0

package/src/templates/commands.js

@@ -5,7 +5,7 @@ export function commands(c) {
       path: `${c.commandsDir}/aped-a.md`,
       content: `---
 name: aped-a
-description: 'Analyze project through parallel research. Use when user says "analyze", "research project", or "aped analyze"'
+description: 'Analyzes a new project idea through parallel market, domain, and technical research. Use when user says "research idea", "aped analyze", or invokes /aped-a. Not for existing codebases — use aped-ctx for brownfield projects.'
 ---
 
 Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-a/SKILL.md
@@ -15,7 +15,7 @@ Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-a/SKILL.md
       path: `${c.commandsDir}/aped-p.md`,
       content: `---
 name: aped-p
-description: 'Generate PRD from product brief. Use when user says "create PRD", "generate PRD", or "aped prd"'
+description: 'Generates PRD autonomously from product brief. Use when user says "create PRD", "generate PRD", "aped prd", or invokes /aped-p.'
 ---
 
 Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-p/SKILL.md
@@ -25,7 +25,7 @@ Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-p/SKILL.md
       path: `${c.commandsDir}/aped-e.md`,
       content: `---
 name: aped-e
-description: 'Create epics and stories from PRD. Use when user says "create epics", "break into stories", or "aped epics"'
+description: 'Creates epics and stories from PRD with full FR coverage. Use when user says "create epics", "break into stories", "aped epics", or invokes /aped-e.'
 ---
 
 Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-e/SKILL.md
@@ -35,7 +35,7 @@ Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-e/SKILL.md
       path: `${c.commandsDir}/aped-d.md`,
       content: `---
 name: aped-d
-description: 'Dev sprint - implement next story with TDD. Use when user says "start dev", "implement story", or "aped dev"'
+description: 'Implements next story with TDD red-green-refactor cycle. Use when user says "start dev", "implement story", "aped dev", or invokes /aped-d.'
 ---
 
 Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-d/SKILL.md
@@ -45,17 +45,77 @@ Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-d/SKILL.md
       path: `${c.commandsDir}/aped-r.md`,
       content: `---
 name: aped-r
-description: 'Adversarial code review for completed story. Use when user says "review code", "run review", or "aped review"'
+description: 'Reviews completed stories adversarially with minimum 3 findings. Use when user says "review code", "run review", "aped review", or invokes /aped-r.'
 ---
 
 Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-r/SKILL.md
+`,
+    },
+    {
+      path: `${c.commandsDir}/aped-ux.md`,
+      content: `---
+name: aped-ux
+description: 'Designs UX specifications from PRD — screen flows, wireframes, component inventory. Use when user says "design UX", "create wireframes", "UX spec", "aped ux", or invokes /aped-ux. Runs between PRD and Epics phases.'
+---
+
+Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-ux/SKILL.md
+`,
+    },
+    {
+      path: `${c.commandsDir}/aped-s.md`,
+      content: `---
+name: aped-s
+description: 'Shows sprint status dashboard with progress, blockers, and next actions. Use when user says "sprint status", "show progress", "aped status", or invokes /aped-s.'
+---
+
+Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-s/SKILL.md
+`,
+    },
+    {
+      path: `${c.commandsDir}/aped-c.md`,
+      content: `---
+name: aped-c
+description: 'Manages scope changes and pivots during development with impact analysis. Use when user says "correct course", "change scope", "pivot", "aped correct", or invokes /aped-c.'
+---
+
+Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-c/SKILL.md
+`,
+    },
+    {
+      path: `${c.commandsDir}/aped-ctx.md`,
+      content: `---
+name: aped-ctx
+description: 'Analyzes existing codebase to generate project context for brownfield development. Use when user says "document codebase", "project context", "existing project", "aped context", or invokes /aped-ctx. Not for new project ideation — use aped-a for greenfield.'
+---
+
+Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-ctx/SKILL.md
+`,
+    },
+    {
+      path: `${c.commandsDir}/aped-qa.md`,
+      content: `---
+name: aped-qa
+description: 'Generates E2E and integration tests from acceptance criteria for completed features. Use when user says "generate tests", "E2E tests", "integration tests", "aped qa", or invokes /aped-qa.'
+---
+
+Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-qa/SKILL.md
+`,
+    },
+    {
+      path: `${c.commandsDir}/aped-quick.md`,
+      content: `---
+name: aped-quick
+description: 'Implements quick fixes and small features bypassing the full pipeline. Use when user says "quick fix", "quick feature", "hotfix", "aped quick", or invokes /aped-quick.'
+---
+
+Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-quick/SKILL.md
 `,
     },
     {
       path: `${c.commandsDir}/aped-all.md`,
       content: `---
 name: aped-all
-description: 'Run full APED pipeline (Analyze>PRD>Epics>Dev>Review). Use when user says "run full pipeline", "aped all", or "start from scratch"'
+description: 'Runs the full APED pipeline from Analyze through Review with auto-resume. Use when user says "run full pipeline", "aped all", or invokes /aped-all.'
 ---
 
 Read and follow the SKILL.md at $PROJECT_ROOT/${a}/aped-all/SKILL.md

package/src/templates/config.js

@@ -1,6 +1,9 @@
 export function configFiles(c) {
   const a = c.apedDir;
   const o = c.outputDir;
+  const ts = c.ticketSystem || 'none';
+  const gp = c.gitProvider || 'github';
+  const ver = c.cliVersion || '0.0.0';
   return [
     {
       path: `${a}/config.yaml`,
@@ -11,10 +14,15 @@ communication_language: ${c.communicationLang}
 document_output_language: ${c.documentLang}
 aped_path: ${a}
 output_path: ${o}
+aped_version: ${ver}
+
+# Integrations
+ticket_system: ${ts}
+git_provider: ${gp}
 `,
     },
     {
-      path: `${a}/state.yaml`,
+      path: `${o}/state.yaml`,
       content: `# APED Pipeline State
 pipeline:
   current_phase: "none"
@@ -224,6 +232,35 @@ sprint:
 ### Completion Notes
 
 ### File List
+`,
+    },
+    {
+      path: `${a}/templates/quick-spec.md`,
+      content: `# Quick Spec: {{title}}
+
+**Date:** {{date}}
+**Author:** {{user_name}}
+**Type:** {{fix|feature|refactor}}
+
+## What
+
+<!-- 1-2 sentences: what needs to change -->
+
+## Why
+
+<!-- 1 sentence: why this change matters now -->
+
+## Acceptance Criteria
+
+- [ ] {{criterion}}
+
+## Files to Change
+
+- {{file_path}} — {{what to change}}
+
+## Test Plan
+
+- {{test description}}
 `,
     },
   ];

package/src/templates/guardrail.js

@@ -13,7 +13,7 @@ export function guardrail(c) {
 set -euo pipefail
 
 PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
-STATE_FILE="$PROJECT_ROOT/${a}/state.yaml"
+STATE_FILE="$PROJECT_ROOT/${o}/state.yaml"
 CONFIG_FILE="$PROJECT_ROOT/${a}/config.yaml"
 OUTPUT_DIR="$PROJECT_ROOT/${o}"
 
@@ -56,6 +56,9 @@ WANTS_CODE=false
 [[ "$PROMPT_LOWER" =~ (aped-d|/aped-d|dev|implement|code|build|create.*component|create.*service) ]] && WANTS_DEV=true
 [[ "$PROMPT_LOWER" =~ (aped-r|/aped-r|review|audit) ]] && WANTS_REVIEW=true
 [[ "$PROMPT_LOWER" =~ (aped-all|/aped-all|full.pipeline|start.from.scratch) ]] && WANTS_ALL=true
+WANTS_QUICK=false
+
+[[ "$PROMPT_LOWER" =~ (aped-quick|/aped-quick|quick.fix|quick.feature|hotfix) ]] && WANTS_QUICK=true
 [[ "$PROMPT_LOWER" =~ (code|implement|write.*function|create.*file|add.*feature|fix.*bug|refactor) ]] && WANTS_CODE=true
 
 # ── Check artifact existence ──
@@ -70,8 +73,8 @@ HAS_EPICS=false
 # ── Phase-aware guardrail logic ──
 WARNINGS=()
 
-# Phase transition map: none → analyze → prd → epics → dev ↔ review → done
-PHASE_ORDER="none analyze prd epics dev review done"
+# Phase transition map: none → analyze → prd → ux → epics → dev ↔ review → done
+PHASE_ORDER="none analyze prd ux epics dev review done"
 
 phase_index() {
   local i=0
@@ -84,6 +87,11 @@ phase_index() {
 
 CURRENT_IDX=$(phase_index "$CURRENT_PHASE")
 
+# Rule 0: Quick mode bypasses pipeline checks
+if [[ "$WANTS_QUICK" == "true" ]]; then
+  exit 0
+fi
+
 # Rule 1: Trying to code without epics/stories
 if [[ "$WANTS_CODE" == "true" || "$WANTS_DEV" == "true" ]] && [[ "$CURRENT_PHASE" != "dev" && "$CURRENT_PHASE" != "review" ]]; then
   if [[ "$HAS_EPICS" == "false" ]]; then

package/src/templates/references.js

@@ -46,6 +46,10 @@ export function references(c) {
       path: `${a}/aped-r/references/review-criteria.md`,
       content: REVIEW_CRITERIA,
     },
+    {
+      path: `${a}/aped-ux/references/ux-patterns.md`,
+      content: UX_PATTERNS,
+    },
   ];
 }
 
@@ -547,3 +551,84 @@ web_app,"website,webapp,browser,SPA,PWA","SPA or MPA?;Browser support?;SEO neede
 mobile_app,"iOS,Android,app,mobile,iPhone,iPad","Native or cross-platform?;Offline needed?;Push notifications?;Device features?;Store compliance?","platform_reqs;device_permissions;offline_mode;push_strategy;store_compliance","desktop_features;cli_commands","app store guidelines;platform requirements","Gesture innovation;AR/VR features"
 saas_b2b,"SaaS,B2B,platform,dashboard,teams,enterprise","Multi-tenant?;Permission model?;Subscription tiers?;Integrations?;Compliance?","tenant_model;rbac_matrix;subscription_tiers;integration_list;compliance_reqs","cli_interface;mobile_first","compliance requirements;integration guides","Workflow automation;AI agents"
 cli_tool,"CLI,command,terminal,bash,script","Interactive or scriptable?;Output formats?;Config method?;Shell completion?","command_structure;output_formats;config_schema;scripting_support","visual_design;ux_principles;touch_interactions","CLI design patterns;shell integration","Natural language CLI;AI commands"`;
+
+const UX_PATTERNS = `# UX Screen Patterns Catalog
+
+## Screen Types
+
+### Form Screens
+- **Login/Register**: email + password, social auth buttons, forgot link
+- **Settings**: grouped sections, save/cancel, inline validation
+- **Wizard/Multi-step**: progress indicator, back/next, step validation
+- **Search + Filters**: search bar, filter sidebar/chips, results list
+
+### List Screens
+- **Data Table**: sortable headers, row actions, pagination, bulk select
+- **Card Grid**: image + title + meta, responsive columns, load more
+- **Feed/Timeline**: chronological, infinite scroll, activity items
+
+### Detail Screens
+- **Profile/Entity**: header (avatar, name, stats), tabbed content, actions
+- **Article/Content**: title, meta, body, sidebar, related items
+
+### Dashboard Screens
+- **Analytics**: stat cards, charts, date range picker, export
+- **Admin**: sidebar nav, content area, notification badge
+
+### Utility Screens
+- **Empty State**: illustration, message, CTA button
+- **Error Page**: error code, message, back/home links
+- **Loading**: skeleton screens, progress bar, spinner
+
+## Layout Patterns
+
+### Navigation
+- **Top Nav**: logo left, nav center/right, avatar far right
+- **Sidebar**: collapsible, icons + labels, active indicator, mobile hamburger
+- **Tab Bar**: bottom tabs (mobile), top tabs (desktop), badge counts
+- **Breadcrumb**: path hierarchy, current page non-linked
+
+### Content Layout
+- **Sidebar + Content**: 240-280px sidebar, fluid content, responsive collapse
+- **Full Width**: max-width container (1200-1440px), centered
+- **Split View**: list left, detail right (email pattern), resizable
+- **Grid**: 12-column, responsive breakpoints (sm/md/lg/xl)
+
+## Interaction Patterns
+
+### Forms
+- **Inline Validation**: validate on blur, show error below field, green checkmark on valid
+- **Progressive Disclosure**: show fields based on previous answers
+- **Autosave**: debounced save, "Saved" indicator, conflict resolution
+
+### Data
+- **Optimistic Updates**: update UI immediately, revert on error
+- **Pagination**: page numbers for known total, infinite scroll for feeds
+- **Search**: debounced input (300ms), loading indicator, clear button
+
+### Feedback
+- **Toast/Snackbar**: bottom-right, auto-dismiss (5s), action button, stacking
+- **Modal/Dialog**: overlay, focus trap, escape to close, confirm/cancel
+- **Inline Alerts**: contextual, dismissible, icon + message + action
+
+## Responsive Breakpoints
+
+| Name | Width | Typical |
+|------|-------|---------|
+| sm | < 640px | Mobile portrait |
+| md | 640-1024px | Tablet / mobile landscape |
+| lg | 1024-1440px | Desktop |
+| xl | > 1440px | Large desktop |
+
+## Accessibility Checklist
+
+- [ ] All interactive elements keyboard-navigable (Tab, Enter, Escape)
+- [ ] Focus indicator visible on all focusable elements
+- [ ] ARIA labels on icon-only buttons
+- [ ] Color contrast ratio ≥ 4.5:1 (text), ≥ 3:1 (large text)
+- [ ] Form fields have associated labels
+- [ ] Error messages linked to fields via aria-describedby
+- [ ] Skip navigation link for screen readers
+- [ ] Alt text on meaningful images
+- [ ] Touch targets ≥ 44x44px on mobile
+`;