learnship

Append a new phase to the current milestone roadmap when scope grows after initial planning

Generate and add test coverage for a specific plan or phase post-execution

Capture a todo/idea mid-session without interrupting flow

Verify milestone met its definition of done — requirement coverage, integration check, stub detection

Review and act on all pending todos captured with add-todo

Archive completed milestone phase directories to keep .planning/phases/ clean

Archive a completed milestone, tag the release, and prepare for the next version

Systematic debugging with persistent state — triage, diagnose root cause, plan fix, execute

Capture an architectural or scope decision with its context, alternatives, and rationale into DECISIONS.md

Batch-diagnose multiple UAT issues after verify-work — groups by root cause, proposes fix plan

Structured codebase discovery before working on an unfamiliar area — reads code, maps dependencies, surfaces risks

Capture milestone-level goals, constraints, and anti-goals before new-milestone starts

Capture implementation decisions for a phase before planning starts

Execute all plans in a phase with wave-based ordered execution, spawning subagents per plan where supported

Run a single PLAN.md file in isolation — useful for re-running a failed plan

Project health check — stale files, uncommitted changes, missing artifacts, config drift

Show all available learnship workflows with descriptions and when to use them

Insert a new phase between existing phases for urgent work discovered mid-milestone

Aggregate key learnings and decisions across all sessions into a searchable KNOWLEDGE.md

Surface the intended approach for a phase before planning starts — validate direction early

Show project status, next step, and offer to run it — start every session here

Analyze an existing codebase and produce structured reference docs before starting a new project on top of it

Structured learning retrospective at end of milestone — 5 questions, produces RETROSPECTIVE.md

Start a new milestone cycle on an existing project after a prior milestone is complete

Initialize a new project — questioning → research → requirements → roadmap

Auto-pilot — reads project state and runs the correct next workflow automatically

Save a handoff file when stopping mid-phase so you can resume seamlessly later

Create fix phases for all gaps found by audit-milestone

Research + create + verify plans for a phase — spawns specialist subagents where supported

Show project progress, current position, and what to do next

<execution_context>

Restore local workflow customizations after updating the platform

Cut a new learnship release — bump version, update changelog, push to public-main, tag, create GitHub release

Remove a planned (not yet executed) phase and renumber subsequent phases

Deep-dive domain research for a phase without immediately creating plans

Restore full project context and continue from where you left off

Quick model profile switch without opening full settings

Interactive settings editor for .planning/config.json

Hand off a project context to a new session or collaborator — writes a HANDOFF.md with full state snapshot

Update the learnship platform itself to the latest version

Retroactive test coverage audit for a completed phase — fill validation gaps without modifying implementation

Manual user acceptance testing — walk through what was built, log issues, create fix plans

Investigates bugs using systematic hypothesis testing — traces from symptoms to root cause, writes investigation findings to the debug session file. Spawned by debug workflow on platforms with subagent support.

Executes a single learnship PLAN.md atomically — one task at a time with per-task commits, deviation handling, and SUMMARY.md creation. Spawned by execute-phase on platforms with subagent support.

Researches how to implement a phase well — identifies pitfalls, recommends existing solutions, and writes RESEARCH.md. Spawned by plan-phase on platforms with subagent support.

Verifies PLAN.md files for a phase — checks goal coverage, requirement IDs, CONTEXT.md decisions, task completeness, and wave correctness. Spawned by plan-phase on platforms with subagent support.

Creates executable PLAN.md files for a phase — decomposes goals into wave-ordered tasks with dependency analysis. Spawned by plan-phase on platforms with subagent support.

Verifies that a phase goal was actually achieved after execution — checks must_haves, requirement coverage, and integration links. Spawned by execute-phase on platforms with subagent support.

A learning partner skill grounded in neuroscience and philosophy. Use when you want to actually learn a concept (not just get an answer), quiz yourself on a codebase, reflect on what you built, brainstorm a design collaboratively, practice productive struggle on a hard problem, journal a decision with its alternatives and consequences, or schedule concepts to revisit later. Invoke with @agentic-learning followed by one of: learn, quiz, reflect, space, brainstorm, explain-first, struggle, either-or, explain, interleave, or cognitive-load.

A design quality system for frontend interfaces. 21 focused actions for auditing, refining, and elevating UI quality. Invoke with @impeccable followed by one of: adapt, animate, arrange, audit, bolder, clarify, colorize, critique, delight, distill, extract, frontend-design, harden, normalize, onboard, optimize, overdrive, polish, quieter, teach-impeccable, or typeset.

Adapt designs to work across different screen sizes, devices, contexts, or platforms. Ensures consistent experience across varied environments.

Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight.

Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy to create intentional compositions.

Perform comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates detailed report of issues with severity ratings and recommendations.

Amplify safe or boring designs to make them more visually interesting and stimulating. Increases impact while maintaining usability.

Improve unclear UX copy, error messages, microcopy, labels, and instructions. Makes interfaces easier to understand and use.

Add strategic color to features that are too monochromatic or lack visual interest. Makes interfaces more engaging and expressive.

Evaluate design effectiveness from a UX perspective. Assesses visual hierarchy, information architecture, emotional resonance, and overall design quality with actionable feedback.

Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful.

Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean.

Extract and consolidate reusable components, design tokens, and patterns into your design system. Identifies opportunities for systematic reuse and enriches your component library.

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics.

Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready.

Normalize design to match your design system and ensure consistency

Design or improve onboarding flows, empty states, and first-time user experiences. Helps users get started successfully and understand value quickly.

Improve interface performance across loading speed, rendering, animations, images, and bundle size. Makes experiences faster and smoother.

Push interfaces past conventional limits with technically ambitious implementations. Whether that's a shader, a 60fps virtual table, spring physics on a dialog, or scroll-driven reveals — make users ask "how did they do that?"

Final quality pass before shipping. Fixes alignment, spacing, consistency, and detail issues that separate good from great.

Tone down overly bold or visually aggressive designs. Reduces intensity while maintaining design quality and impact.

One-time setup that gathers design context for your project and saves it to your AI config file. Run once to establish persistent design guidelines.

Improve typography by fixing font choices, hierarchy, sizing, weight consistency, and readability. Makes text feel intentional and polished.

1 hook across 1 event