Skip to main content

jaan.to Roadmap

See vision.md for philosophy and concepts

Overview​

PhaseFocusStatus
1-3Foundation, migration, customizationDone (see CHANGELOG.md)
4Development workflowPlanned
5Detect & Knowledge Pack (6 skills)Done
6Role skills (141 across 11 roles)In Progress
7MCP connectorsPlanned
8Testing and polishPlanned
9DistributionPartial

Version History​

For complete release history, see CHANGELOG.md.

Latest: v3.23.0 — Detect & Knowledge Pack (6 skills)

v3.23.0 — Detect & Knowledge Pack (6 skills)​

  • 6 detect skills: detect-dev, detect-design, detect-writing, detect-product, detect-ux, pack-detect (52eb72f..50a75f5)
  • dev-stack-detect merged into detect-dev and removed (bb9d0a7, 9d944de)
  • 30+ reference files updated, bootstrap updated (9d944de)
  • All detect docs aligned with implementations (29901ae)
  • Bootstrap .gitignore fix (c95e4a9)

v3.22.0 — Language settings in all 21 skills​

  • Language settings support in all 21 skills (b7cfa00)
  • Docusaurus documentation site (7bec2d3)
  • Roadmap moved to docs/roadmap/ (f332657)
  • Versioning unified — removed -dev suffix (37516ab)

v3.21.0 — Jaanify showcase examples​

  • Examples replaced with Jaanify showcase README (0bf37a1)
  • Plugin and marketplace version sync fix (807cad5)

v3.20.0 — Language preference system​

  • Language preference for plugin conversation and output (34df511)
  • Documentation: customization guide and seed files updated (5fe2a18)

Unreleased​

Phase 4: Development Workflow​

Details: tasks/development-workflow.md | tasks/lsp-support.md

  • Project constitution document (context/constitution.md) — 9 immutable development principles
  • Complexity tracking in outputs — [NEEDS CLARIFICATION], [COMPLEXITY], [EXCEPTION], [TRADEOFF] markers
  • LSP support — Bundle TypeScript + Python language server configs, make skills LSP-aware

Phase 5: Detect & Knowledge Pack (6 skills) — DONE​

Details: tasks/role-skills/detect.md

Evidence-based repo audits that produce docs/current/ knowledge. All detect skills are Quick Wins (no MCP required). Each outputs machine-parseable markdown with YAML frontmatter, SARIF-like evidence blocks, and confidence scoring.

Pipeline: detect-dev + detect-design + detect-writing + detect-product + detect-ux → pack-detect

  • /jaan-to:detect-dev — Engineering audit with OpenSSF scoring (52eb72f)
  • /jaan-to:detect-design — Design system detection with drift findings (280e4f7)
  • /jaan-to:detect-writing — Writing system extraction with NNg tone scoring (eb0b4f5)
  • /jaan-to:detect-product — Product reality extraction with 3-layer evidence (ef3d455)
  • /jaan-to:detect-ux — UX audit with Nielsen heuristics and journey mapping (6fa7cb5)
  • /jaan-to:pack-detect — Consolidate detect outputs into knowledge index (50a75f5)
  • Merge dev-stack-detect into detect-dev and remove (bb9d0a7)
  • Update all references (30+ files) (9d944de)
  • Align detect docs with implementations (29901ae)

Phase 6: Role Skills (141 across 11 roles)​

Details: tasks/role-skills.md

141 skills cataloged across 11 roles. Quick-win skills (no MCP required) are built first, followed by advanced skills that depend on MCP connectors.

All new skills must follow v3.0.0 patterns: $JAAN_* environment variables, template variables, tech stack integration, and pass /jaan-to:skill-update validation.

RoleTotalQuick WinsAdvancedFile
PM24186pm.md
DEV19154dev.md
QA1284qa.md
DATA1486data.md
GROWTH1596growth.md
UX20155ux.md
SEC440sec.md
DELIVERY880delivery.md
SRE954sre.md
SUPPORT880support.md
RELEASE880release.md

Priority (by research rank): qa-test-cases (#1), data-sql-query (#2), ux-research-synthesize (#8), qa-bug-report (#10), growth-meta-write (#12). Full priority list in tasks/role-skills.md.

Phase 7: MCP Connectors (24 documented)​

Details: tasks/mcp-connectors.md

MCP connectors provide real system context to skills. Skills stay generic; MCP provides per-product data from actual tools.

  • Core MCPs (11): GA4, GitLab, Jira, Figma, GSC, Clarity, Sentry, BigQuery, Playwright, OpenAPI, dbt Cloud
  • Extended MCPs (13): Notion, Slack, GitHub, Linear, Mixpanel, Confluence, Snowflake, PostgreSQL, Ahrefs, Semrush, LambdaTest, Google Drive, Memory
  • Infrastructure: Deferred loading for token savings, Context7 integration, model routing per skill type

Phase 8: Testing and Polish​

  • E2E test framework in tests/ with mocked MCP responses
  • JSON export alongside markdown for all skill outputs
  • External notifications (Slack integration)
  • Fix learn-report skill hook script for macOS compatibility (Bash 3.2 — needs 4+ for declare -A)

Phase 9: Distribution​

Details: tasks/distribution.md

  • Plugin marketplace installation (/plugin marketplace add parhumm/jaan-to)
  • Multi-agent compatibility research (Cursor, Copilot, Windsurf, Gemini)
  • CLI installer (jaan-to-cli) for one-command setup
  • Public documentation site and branding guidelines

Quick Reference​

Commands​

CommandDescription
/jaan-to:pm-prd-writeGenerate PRD from initiative
/jaan-to:pm-research-aboutDeep research or add file/URL to index
/jaan-to:pm-story-writeGenerate user stories with Given/When/Then AC
/jaan-to:data-gtm-datalayerGenerate GTM tracking code
/jaan-to:detect-devEngineering audit with scored findings
/jaan-to:detect-designDesign system detection with drift findings
/jaan-to:detect-writingWriting system extraction with tone scoring
/jaan-to:detect-productProduct reality extraction with evidence
/jaan-to:detect-uxUX audit with journey/pain-point findings
/jaan-to:pack-detectConsolidate detect outputs into knowledge index
/jaan-to:dev-fe-task-breakdownFrontend task breakdown with component hierarchy
/jaan-to:dev-be-task-breakdownBackend task breakdown from PRDs
/jaan-to:dev-fe-designFrontend component design
/jaan-to:dev-be-data-modelGenerate data model docs with constraints, indexes, and migrations
/jaan-to:dev-api-contractGenerate OpenAPI 3.1 contracts from API entities
/jaan-to:ux-heatmap-analyzeAnalyze heatmap CSV + screenshots
/jaan-to:ux-microcopy-writeMulti-language UX microcopy
/jaan-to:ux-research-synthesizeSynthesize UX research findings
/jaan-to:qa-test-casesGenerate test cases from PRDs
/jaan-to:skill-createCreate new skill with wizard
/jaan-to:skill-updateUpdate existing skill
/jaan-to:docs-createCreate documentation with templates
/jaan-to:docs-updateAudit and update stale documentation
/jaan-to:learn-addAdd lesson to skill's LEARN.md
/jaan-to:roadmap-addAdd task to roadmap
/jaan-to:roadmap-updateMaintain and sync roadmap
/jaan-to:learn-reportView learning system dashboard

Key Paths​

PathPurpose
skills/Skill definitions (plugin-relative)
jaan-to/config/settings.yamlProject configuration (v3.0.0+)
jaan-to/context/Context templates (project-relative)
jaan-to/templates/Output templates (project-relative)
jaan-to/outputs/Generated outputs (project-relative)
jaan-to/learn/Learning files (project-relative)
.claude-plugin/plugin.jsonPlugin manifest
docs/roadmap/tasks/Task details

Skill Naming​

PatternExample
Role-based: {role}-{domain}-{action}/jaan-to:pm-prd-write
Internal: {domain}-{action}/jaan-to:skill-create
Directory: skills/{skill-name}/skills/jaan-to:pm-prd-write/