main

Retrieves authoritative documentation directly from the framework's official repository.

When to Use

Called during i18n_checklist Steps 1-13.

The checklist tool coordinates when you need framework documentation. Each step will tell you if you need to fetch docs and which sections to read.

If you're implementing i18n: Let the checklist guide you. Don't call this independently

Why This Matters

Your training data is a snapshot. Framework APIs evolve. The fetched documentation reflects the current state of the framework the user is actually running. Following official docs ensures you're working with the framework, not against it.

How to Use

Two-Phase Workflow:

1. Discovery - Call with action="index" to see available sections

2. Reading - Call with action="read" and section_id to get full content

Parameters:

• framework: Use the exact value from get_project_context output

• version: Use "latest" unless you need version-specific docs

• action: "index" or "read"

• section_id: Required for action="read", format "fileIndex:headingIndex" (from index)

Example Flow:

What You Get

• Index: Table of contents with section IDs

• Read: Full section with explanations and code examples

Use these patterns directly in your implementation.

Retrieves authoritative documentation for i18n libraries (currently react-intl).

When to Use

Called during i18n_checklist Steps 7-10.

The checklist tool will tell you when you need i18n library documentation. Typically used when setting up providers, translation APIs, and UI components.

If you're implementing i18n: Let the checklist guide you. It will tell you when to fetch library docs

Why This Matters

Different i18n libraries have different APIs and patterns. Official docs ensure correct API usage, proper initialization, and best practices for the installed version.

How to Use

Two-Phase Workflow:

1. Discovery - Call with action="index"

2. Reading - Call with action="read" and section_id

Parameters:

• library: Currently only "react-intl" supported

• version: Use "latest"

• action: "index" or "read"

• section_id: Required for action="read"

Example:

What You Get

• Index: Available documentation sections

• Read: Full API references and usage examples

Captures the user's project architecture to inform i18n implementation strategy.

When to Use

Called during i18n_checklist Step 1.

The checklist tool will tell you when to call this. If you're implementing i18n:

1. Call i18n_checklist(step_number=1, done=false) FIRST

2. The checklist will instruct you to call THIS tool

3. Then use the results for subsequent steps

Do NOT call this before calling the checklist tool

Why This Matters

Frameworks handle i18n through completely different mechanisms. The same outcome (locale-aware routing) requires different code for Next.js vs TanStack Start vs React Router. Without accurate detection, you'll implement patterns that don't work.

How to Use

1. Examine the user's project files (package.json, directories, config files)

2. Identify framework markers and version

3. Construct a detectionResults object matching the schema

4. Call this tool with your findings

5. Store the returned framework identifier for get_framework_docs calls

The schema requires:

• framework: Exact variant (nextjs-app-router, nextjs-pages-router, tanstack-start, react-router)

• majorVersion: Specific version number (13-16 for Next.js, 1 for TanStack Start, 7 for React Router)

• sourceDirectory, hasTypeScript, packageManager

• Any detected locale configuration

• Any detected i18n library (currently only react-intl supported)

What You Get

Returns the framework identifier needed for documentation fetching. The 'framework' field in the response is the exact string you'll use with get_framework_docs.

⚠️ MANDATORY TOOL FOR ALL I18N WORK ⚠️

THIS IS NOT OPTIONAL. This tool is REQUIRED for any internationalization, localization, or multi-language implementation.

When to Use (MANDATORY)

ALWAYS use this tool when the user says ANY of these phrases:

• "set up i18n"

• "add internationalization"

• "implement localization"

• "support multiple languages"

• "add translations"

• "make my app multilingual"

• "add French/Spanish/etc support"

• "implement i18n"

• "configure internationalization"

• "add locale support"

• ANY request about supporting multiple languages

Recognition Pattern:

Why This is Mandatory

Without this tool, you will: ❌ Miss critical integration points (80% failure rate) ❌ Implement steps out of order (causes cascade failures) ❌ Use patterns that don't work for the framework ❌ Create code that compiles but doesn't function ❌ Waste hours debugging preventable issues

This tool is like Anthropic's "think" tool - it forces structured reasoning and prevents catastrophic mistakes.

The Forcing Function

You CANNOT proceed to step N+1 without completing step N. You CANNOT mark a step complete without providing evidence. You CANNOT skip the build check for steps 2-13.

This is by design. The tool prevents you from breaking the implementation.

How It Works

This tool gives you ONE step at a time:

1. Shows exactly what to implement

2. Tells you which docs to fetch

3. Waits for concrete evidence

4. Validates your build passes

5. Unlocks the next step only when ready

You don't need to understand all 13 steps upfront. Just follow each step as it's given.

FIRST CALL (Start Here)

When user requests i18n, your IMMEDIATE response must be:

This returns Step 1's requirements. That's all you need to start.

Workflow Pattern

For each of the 13 steps, make TWO calls:

CALL 1 - Get Instructions:

[You implement the requirements using other tools]

CALL 2 - Submit Completion:

Repeat until all 13 steps complete.

Parameters

• step_number: Integer 1-13 (must proceed sequentially)

• done: Boolean - false to view requirements, true to submit completion

• evidence: Array of objects (REQUIRED when done=true)

  • file_path: Where you made the change

  • code_snippet: The actual code (5-20 lines)

  • explanation: How it satisfies the requirement

• build_passing: Boolean (REQUIRED when done=true for steps 2-13)

Decision Tree

Example: Correct AI Behavior

Example: Incorrect AI Behavior (DON'T DO THIS)

Why Sequential Steps Matter

The 13 steps have strict dependencies:

• Can't implement routing (step 3) without locale resolution (step 2)

• Can't load translations (step 6) without data source (step 5)

• Can't use translation API (step 8) without context (step 7)

• Can't add UI switcher (step 12) without switching logic (step 11)

Skipping or reordering steps creates broken implementations that are hard to debug.

Common Mistakes to Avoid

❌ "Let me plan out the implementation first" → NO, call the tool ❌ "Let me check your project structure" → NO, call the tool (it will tell you when) ❌ "I'll implement based on my knowledge" → NO, call the tool (it fetches current docs) ❌ "I'll skip step X since it seems optional" → NO, all steps are mandatory ❌ "I've done this before, I know what to do" → NO, frameworks differ, use the tool

The Tool Coordinates Everything

This tool tells you when to:

• Call get_project_context (step 1)

• Call get_framework_docs (steps 2-13)

• Call get_i18n_library_docs (steps 7-10)

• Implement specific code (every step)

• Run builds (steps 2-13)

• Move to the next step (after evidence validation)

Don't try to orchestrate this yourself. Let the tool guide you.

Summary: Your First Action

When user requests i18n support:

1. Recognize the trigger words (internationalization, localization, i18n, etc)

2. IMMEDIATELY call: i18n_checklist(step_number=1, done=false)

3. Follow the instructions it returns

4. That's it - the tool handles the rest

This is not a suggestion. This is MANDATORY for all i18n work.