Agent-Skills.md

Agent Skills: Framework Context

Load and synthesize framework architecture context for reflection and planning tasks.

UncategorizedID: oimiragieo/agent-studio/framework-context

Repository

oimiragieo/agent-studio
oimiragieo
19

Install this agent skill to your local

pnpm dlx add-skill https://github.com/oimiragieo/agent-studio/tree/HEAD/.claude/skills/framework-context

Skill Files

Browse the full folder contents for framework-context.

Download Skill

Loading file tree…

.claude/skills/framework-context/SKILL.md

Skill Metadata

Name
framework-context
Description
Load and synthesize framework architecture context for reflection and planning tasks.

Framework Context

Overview

Provide a consistent, source-anchored model of this framework so agents can reason about system-level behavior without guessing.

When to Use

  • System-level reflection or metacognitive assessment
  • Planning tasks that depend on routing/memory/workflow architecture
  • Capability-gap analysis before recommending ecosystem evolution

Iron Laws

  1. ALWAYS load framework context before any system-level reflection, planning, or capability-gap analysis — reasoning about architecture without grounding produces hallucinated paths and phantom agents.
  2. NEVER fabricate file paths or agent names that are not confirmed by reading canonical sources — invented paths break downstream agents that try to use them.
  3. ALWAYS scope the context load to only what the consuming task needs (memory, agents, workflows, hooks, or all) — loading all sources for a narrow task wastes tokens and buries relevant signals.
  4. NEVER write or modify framework files from within this skill — framework-context is read-only; mutations require the appropriate creator/updater skill.
  5. ALWAYS report missing sources explicitly as missing source: <path> rather than silently omitting a section — silent omissions cause downstream agents to make decisions on incomplete context.

Anti-Patterns

| Anti-Pattern | Why It Fails | Correct Approach | | ------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------- | | Skipping context load before reflection | Reflection uses stale or hallucinated routing/memory assumptions | Always invoke framework-context first; never reflect from memory alone | | Loading full all scope for a narrow task | Token budget consumed by irrelevant sections; key signal buried | Pass --scope memory or --scope agents to limit output to what's needed | | Inferring file paths from naming conventions | Paths change; inferred paths break agent pipelines | Always read canonical sources and report actual paths found | | Writing to framework files inside this skill | Bypasses creator workflow and post-creation integration steps | Use appropriate creator/updater skill for any write operations | | Silently omitting sections when source is missing | Consumer assumes context is complete; makes decisions on gaps | Report missing source: <path> explicitly for every unresolvable section |

<identity> Framework grounding skill for memory architecture, routing, workflows, hooks, and directory layout. </identity> <capabilities> - Produce scoped context summaries (`memory`, `agents`, `workflows`, `hooks`, `all`) - Anchor every section to concrete repository paths - Standardize framework context output for reflection/planning consumers </capabilities> <instructions> <execution_process>

Step 0: Resolve Scope

  • Accept scope argument: memory | agents | workflows | hooks | all
  • Default to all

Step 1: Load Canonical Sources

Read only what is required by scope:

  • Memory: .claude/docs/MEMORY_SYSTEM.md
  • Agent registry/routing: .claude/context/agent-registry.json, .claude/lib/routing/routing-table.cjs
  • Reflection flow hooks: .claude/hooks/reflection/reflection-queue-processor.cjs, .claude/hooks/reflection/reflection-step0-guard.cjs
  • Workflow catalog: .claude/docs/@ENTERPRISE_WORKFLOWS.md
  • Global framework references: .claude/CLAUDE.md

Step 2: Emit Structured Context

Output sections in this exact order:

  1. Memory System
  2. Agents and Routing
  3. Workflows
  4. Hooks
  5. Directory Layout

Each section must include:

  • 2-6 concise bullets
  • At least one concrete path reference
  • Behavior notes (what triggers what)

Step 3: Scope Filter

  • If scope != all, return only relevant section(s)
  • Never fabricate unknown paths or flows
  • If a source is missing, state missing source: <path>

Step 3: Output

Return markdown only; do not write framework files from this skill.

</execution_process> </instructions>

<examples> <usage_example> **Example Invocations**: 
// Full framework model
Skill({ skill: 'framework-context' });

// Memory-only context for reflection prep
Skill({ skill: 'framework-context', args: '--scope memory' });

// Workflow/hook-only context for integration analysis
Skill({ skill: 'framework-context', args: '--scope workflows' });

</usage_example> </examples>

Memory Protocol (MANDATORY)

Before starting:

Get-Content .claude/context/memory/learnings.md -TotalCount 120

After completing:

  • New framework-context pattern -> .claude/context/memory/learnings.md
  • Broken/ambiguous framework mapping -> .claude/context/memory/issues.md
  • Architectural interpretation decision -> .claude/context/memory/decisions.md

ASSUME INTERRUPTION: Your context may reset. If it's not in memory, it didn't happen.