Reasoning Framework
by ahonn
Reasoning and planning framework. Defines task analysis, risk assessment, hypothesis forming. Applied automatically for complex requests.
Skill Details
Repository Files
1 file in this skill directory
name: reasoning-framework description: "Reasoning and planning framework. Defines task analysis, risk assessment, hypothesis forming. Applied automatically for complex requests." user-invocable: false
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)
Related Skills
Attack Tree Construction
Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.
Grafana Dashboards
Create and manage production Grafana dashboards for real-time visualization of system and application metrics. Use when building monitoring dashboards, visualizing metrics, or creating operational observability interfaces.
Matplotlib
Foundational plotting library. Create line plots, scatter, bar, histograms, heatmaps, 3D, subplots, export PNG/PDF/SVG, for scientific visualization and publication figures.
Scientific Visualization
Create publication figures with matplotlib/seaborn/plotly. Multi-panel layouts, error bars, significance markers, colorblind-safe, export PDF/EPS/TIFF, for journal-ready scientific plots.
Seaborn
Statistical visualization. Scatter, box, violin, heatmaps, pair plots, regression, correlation matrices, KDE, faceted plots, for exploratory analysis and publication figures.
Shap
Model interpretability and explainability using SHAP (SHapley Additive exPlanations). Use this skill when explaining machine learning model predictions, computing feature importance, generating SHAP plots (waterfall, beeswarm, bar, scatter, force, heatmap), debugging models, analyzing model bias or fairness, comparing models, or implementing explainable AI. Works with tree-based models (XGBoost, LightGBM, Random Forest), deep learning (TensorFlow, PyTorch), linear models, and any black-box model
Pydeseq2
Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.
Query Writing
For writing and executing SQL queries - from simple single-table queries to complex multi-table JOINs and aggregations
Pydeseq2
Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.
Scientific Visualization
Meta-skill for publication-ready figures. Use when creating journal submission figures requiring multi-panel layouts, significance annotations, error bars, colorblind-safe palettes, and specific journal formatting (Nature, Science, Cell). Orchestrates matplotlib/seaborn/plotly with publication styles. For quick exploration use seaborn or plotly directly.
