jaan-to

Jaan.to — Give soul to your product

AI-powered skills for PM, Data, QA, Dev workflows. PRD generation, GTM tracking, documentation management, and more.

Plugin Contents

Component	Count	Description
Skills	56	PM, Dev, Backend, Frontend, QA, UX, Data, Detect, WordPress, Release, Security, DevOps, Core
Agents	3	quality-reviewer, context-scout, visual-reviewer
Hooks	7	Setup, SessionStart, PreToolUse, PostToolUse, Stop, TaskCompleted, TeammateIdle
Output Styles	2	enterprise-doc, concise-summary

---

What is "jaan"?

"Jaan" is a Persian word meaning "soul" or "life." When you say "jaan-e man" — "my soul" — you're expressing the deepest form of care.

Jaan.to means "giving soul to something" — a person, a project, a product. It's the act of breathing life into work that would otherwise feel mechanical.

---

Installation

Claude Code Quick Install

claude
/plugin marketplace add parhumm/jaan-to
/plugin install jaan-to
/jaan-init

Codex Quick Install

# One-command installer (recommended for end users)
bash <(curl -fsSL https://raw.githubusercontent.com/parhumm/jaan-to/main/scripts/install-codex-skillpack.sh)

# Fallback if you're in this repo locally
bash ./scripts/install-codex-skillpack.sh

Then:

1. Restart Codex.
2. Open your project in Codex.
3. Run /jaan-init once.
4. Use /skills, /jaan-to:*, /jaan-init, or native $skill mentions.

Examples:

/skills
/jaan-init
/jaan-to:pm-prd-write
$pm-prd-write

In Codex, /jaan-to:* and /jaan-init are intentionally preserved as aliases for native $skill.

Claude Code Version Management

Development version:

claude
/plugin marketplace add parhumm/jaan-to#dev
/plugin install jaan-to
/jaan-init

Switch stable/dev:

/plugin uninstall jaan-to
/plugin marketplace add parhumm/jaan-to       # stable
/plugin marketplace add parhumm/jaan-to#dev   # dev
/plugin install jaan-to
/jaan-init

Check installed version:

/plugin list

Local Development + Build Commands

# Claude local dev
claude --plugin-dir /path/to/jaan-to

# Build both runtime targets
./scripts/build-all-targets.sh

# Build Codex skillpack source
bash ./scripts/build-codex-skillpack.sh

# Skillpack drift guard
bash ./scripts/validate-codex-skillpack.sh

# Skill PR prep (regenerate + validate + stage skillpack)
bash ./scripts/prepare-skill-pr.sh

# Integrated dual-runtime smoke
bash scripts/test/e2e-dual-runtime-smoke.sh

Codex Local Mode (Legacy/Debug Only)

./scripts/build-target.sh codex
cd ./dist/jaan-to-codex
./jaan-to setup /path/to/your-project --mode local

setup --mode auto resolves to global if ~/.agents/skills/jaan-to-codex-pack exists, otherwise local.

Codex Troubleshooting

• Installer auto method SSL failure:
  • Wrapper retries automatically with --method git.
• $skill ambiguity from duplicate names:
  • Remove duplicate project .agents/skills/<jaan-to-skill> entries and use global mode.
• Skills not appearing:
  • Restart Codex after install/reinstall.

Claude Compatibility Guarantee

Claude Code installation, command namespace (/jaan-to:*), and plugin behavior remain unchanged. Codex support is added as a thin adapter and runner layer without changing Claude runtime contracts.

First run

The bootstrap hook automatically creates jaan-to/ in your project with:

• context/ — Config and boundary templates (customize for your project)
• templates/ — Output templates for each skill
• learn/ — Learning seeds (improve over time)
• outputs/ — Generated outputs (PRDs, tracking code, research, etc.)
• docs/ — Reference docs (style guide, skill spec)

Verify installation

./scripts/verify-install.sh /path/to/your-project

---

Optional: Project-Level Configuration

jaan.to follows Claude Code best practices by NOT shipping with configuration files. All settings are OPTIONAL and should be added to YOUR project's .claude/settings.json if needed.

Why? Configuration is project-specific, not plugin-specific. This keeps the plugin portable and ensures you maintain full control over permissions and environment variables in your own codebase.

See Recommended Permissions below for examples of common permission patterns.

---

Available Skills

Product Management