agent-methodology

Applies a five-stage methodology to plan and execute non-trivial multi-step engineering work.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill agent-methodology-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-methodology
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/agent-methodology
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill agent-methodology-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-trivial tasks like architecture changes, complex refactors, and contract migrations often fail because agents skip grounding, design, or verification steps. This Skill structures that work into the orama-system five-stage methodology so each stage is completed and verified before moving on. ## Core Features & Use Cases - Five-Stage Workflow: Context Immersion, Visionary Architecture, Ruthless Refinement, Masterful Execution, and Crystallize Vision, with explicit feedback loops between stages. - Contract Migration Gate: Maps the full vertical slice (persistence, contract, callers, transport, lifecycle, tests) before changing durable state, return contracts, event envelopes, or transport payloads. - Post-Review Micro-Remediation: Clusters PR review findings by root cause and fixes once at the abstraction level, avoiding revert chains. - Use Case: When asked to change an API response contract, the agent first maps every caller and transport layer, then implements and verifies each step before crystallizing the result. ## Quick Start Ask the agent to apply the five-stage methodology to plan and execute your next multi-step refactoring or architecture task.

Frequently Asked Questions about agent-methodology

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I apply a structured methodology to multi-step coding tasks?

Apply the five stages in order: immerse in context, map the architecture, refine the design, execute one verified task at a time, then crystallize the result. Loop back to an earlier stage whenever a later stage reveals a flawed assumption.

What is the contract migration gate for API changes?

The contract migration gate requires mapping the full vertical slice before changing durable state, return contracts, event envelopes, or transport payloads. It covers persistence, contract, callers, transport, lifecycle, and tests so no consumer is missed.

When should I not use the five-stage methodology?

Do not use it for direct factual answers or isolated formatting edits. The methodology is designed for non-trivial multi-step planning, architecture, refactoring, and contract-changing work where skipping stages creates risk.

How should I handle code review findings on a pull request?

Cluster findings by root cause and fix once at the abstraction level rather than patching symptoms. Keep each commit attributable to its failure class, and reset to a safety-ref-protected ancestor instead of accumulating revert chains.

Which AI coding agents support this methodology skill?

The skill declares compatibility with Claude Code, Codex, Gemini, OpenClaw, and Hermes. It is a prompt-level methodology card, so it works with any agent that loads SKILL.md files.