ai-docs/docs/ai/cross-platform.md

Cross-Platform AI Usage

Agents.md

What It Is

Agents define a structured workflow so tasks are broken into clear steps, with explicit inputs and outputs.

How to Use It

1. Read Agents.md.
2. Choose a workflow that matches your task.
3. Provide the inputs in a short, bounded request.

When to Use Agents vs Chat

• Use agents for multi-step tasks like refactors, doc audits, or migrations.
• Use chat for quick questions or one-off explanations.

Request Template

Use this structure to get consistent results:

Goal: <one sentence>
Inputs: <files, constraints, context>
Output: <expected deliverable>
Verification: <tests or checks>

Prompting Patterns

• Refactors: "Refactor this file to improve readability without changing behavior."
• Tests: "Add unit tests for this service. Keep the existing public API."
• Debugging: "Explain this error and list likely fixes in order."
• Understanding code: "Summarize what this module does and call out risks."

Plan-First Workflow

1. Ask for a short plan.
2. Approve or adjust the plan.
3. Ask for targeted changes.
4. Verify with tests or review.

Connecting Skills

• Use skills for tasks with known workflows.
• Combine multiple skills when a task spans domains.
• Pass concise context between steps to reduce repetition.

Efficiency Tips

• Keep prompts small and scoped.
• Reuse context from earlier steps instead of repeating it.
• Ask for summaries before asking for edits.