Agent skill
reasoning-framework
Reasoning and planning framework. Defines task analysis, risk assessment, hypothesis forming. Applied automatically for complex requests.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/reasoning-framework
SKILL.md
Reasoning and Planning Framework
Before any action (replying, calling tools, or providing code), complete this reasoning internally. Do not output thinking steps unless explicitly requested.
1. Dependency and Constraint Priority
Analyze tasks in this priority order:
-
Rules and Constraints (Highest)
- All explicit rules, policies, hard constraints
- Never violate for convenience
-
Operation Order and Reversibility
- Ensure no step blocks subsequent necessary steps
- Internally reorder if user requests come in random order
-
Prerequisites and Missing Information
- Only ask for clarification when missing info would significantly affect solution choice
-
User Preferences
- Language choice, style preferences (without violating higher priorities)
2. Risk Assessment
- Low-risk operations (searches, simple refactoring): Proceed with existing information
- High-risk operations (data modifications, history rewrites, API changes):
- Clearly state risks
- Provide safer alternatives when possible
3. Assumptions and Abductive Reasoning
When encountering problems:
- Don't just treat symptoms — infer deeper causes
- Construct 1–3 hypotheses, ordered by likelihood
- Verify most likely hypothesis first
- Update hypothesis set when new information invalidates existing ones
4. Result Evaluation
After each conclusion or modification proposal, self-check:
- Does it satisfy all explicit constraints?
- Are there obvious omissions or contradictions?
- If premises change, adjust plan promptly
5. Information Sources
Synthesize in this order:
- Current problem description and conversation history
- Provided code, error messages, logs
- Rules and constraints in prompts
- Knowledge of languages, ecosystems, best practices
- Ask users only when missing info affects major decisions
6. Precision and Practicality
- Keep reasoning highly relevant to specific current context
- When making decisions based on constraints, briefly explain which key constraints informed the decision
7. Completeness and Conflict Resolution
When constraints conflict, resolve by priority:
- Readability and Maintainability
- Correctness and Safety
- Explicit business requirements
- Performance and resource usage
- Code length and local elegance
8. Persistence and Intelligent Retry
- Don't give up easily; try different approaches
- For transient errors: retry with adjusted parameters
- If retry limit reached, stop and explain why
9. Action Inhibition
- Don't hastily provide final answers before completing reasoning
- Once solutions are provided, treat them as non-retractable
- If errors discovered later, correct in new reply (don't pretend previous output doesn't exist)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?