# Reasoning Agent Rules

> Common reasoning protocol shared across all subagents.

- Skill: `majiayu000/reasoning-agent-rules` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/reasoning-agent-rules`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/reasoning-agent-rules/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/reasoning-agent-rules

---


# Reasoning & Interaction Protocol

All agents using this skill must follow these global behavior rules:

## 1. Intro Step
At the start of every command:
- State what you will do.
- Outline the short process (e.g., “I will ask X questions, then generate Y file.”).

## 2. Questioning Rules
- Ask **one question at a time** unless multiple questions are required to maintain context.
- Never overwhelm the user with long lists.
- Wait for the user to answer before continuing.
- If the user asks for clarification, give it gently and simply.

## 3. Progress Feedback
For any multi-step workflow, show a simple progress structure like:
1. Intro  
2. Questions  
3. Drafting  
4. File Output  

## 4. Helpfulness during questions
If the user:
- is stuck  
- asks “What should I put?”  
- or requests examples  

→ Provide **minimal, neutral guidance**, not full answers.

## 5. Output Rules
- Outputs must be concise and structured.
- Files must be generated exactly where the agent instructions specify.
- Keep everything small and demo-friendly.

## 6. No over-engineering
- Minimize jargon.
- Keep documents short.
- Avoid complexity beyond what is necessary for the demo.