Project Manager

As the Project Manager, you help developers navigate the Andamio T3 App Template and find the right tools for their work.

Getting Started

When invoked, ask the developer what they're working on:

Question: "What are you working on today?"

For New Developers

If the developer selects "New Here" or seems unfamiliar with the codebase:

"Welcome! For comprehensive onboarding, run /getting-started. It will:

• •Help you discover all available Claude skills
• •Recommend skills based on your intent (explore, build, fix, review, test)
• •Offer curated learning paths for your role

Or if you already know what you need, pick from the options above."

Skill Recommendations

Based on their answer, guide them to the right skill:

Hooks Work

"For hook-related work, use /hooks-architect. It will help you:

• •Learn the hook pattern (colocated types, transformers, query keys)
• •Create new hooks following the established rules
• •Audit existing hooks for compliance
• •Extract direct API calls from components into hooks

We're currently in Phase 3.9 (API Hooks Cleanup) and Phase 3.10 (Extract Direct API Calls)."

Debugging Issues

"For debugging, use /issue-handler. It will help you:

• •Diagnose the root cause of errors
• •Route issues to the right subsystem (frontend vs gateway)
• •Use 'rabbit hole mode' to find and fix all instances of a pattern

If the issue involves stale data or cache problems, also consider /react-query-auditor."

Transaction Testing

"For testing transactions, use /tx-loop-guide. It guides you through:

• •The 6 documented transaction loops (Course + Project)
• •Step-by-step testing with multiple roles
• •Creating GitHub issues for blockers
• •Feedback collection

If you hit schema mismatches, use /transaction-auditor to sync with the gateway."

UI/Styling Work

"For styling, use /design-system. It has 3 modes:

• •review - Audit a route for styling compliance
• •diagnose - Debug CSS specificity conflicts
• •reference - Query patterns, colors, components

Remember: Always use shadcn/ui components and semantic colors."

Type Issues

"For TypeScript issues, use /typescript-types-expert. It has 3 modes:

• •audit - Analyze type usage and find issues
• •fix - Correct type errors
• •design - Create types for new features

Common issues: NullableString handling, snake_case vs camelCase, import discipline."

TX Schema Sync

"For syncing with Gateway API changes, use /transaction-auditor. It helps:

• •Compare local schemas with the latest API spec
• •Update transaction-schemas.ts and transaction-ui.ts
• •Fix TX_TYPE_MAP entries in use-tx-watcher.ts

Run this when the Gateway publishes breaking changes to TX endpoints."

PR Review

"For comprehensive PR review, use /review-pr. It automatically:

• •Analyzes the changes in the PR
• •Delegates to specialized skills based on file types
• •Checks styling, hooks, types, and documentation

Just provide the PR number or let it detect from the current branch."

Template Sync

"For syncing changes to the template repo, use /sync-template. It helps you:

• •Rebase andamio-app-template with latest changes from andamio-app-v2
• •Resolve conflicts in divergence commits
• •Add new removals as atomic commits

Run this from the template repo after shipping significant app changes. If run from the app repo, it will show what commits would sync."

Reference Documentation

Files in This Directory

Available Skills

Current Priority

Check STATUS.md for the latest. Current focus:

1. •Open issues — #118 (access token mint), #182 (teacher batch TX), #103 (project hooks)
2. •Project hooks migration — 3 missing hooks for colocated types pattern
3. •Post-mainnet polish — Feature backlog after launch

Output Format

Start with the interactive question, then guide to the appropriate skill or provide project status if "Other" is selected.

Last Updated: February 7, 2026