Skip to content
 
 

Repository files navigation

Step Beyond banner


🧠 Step Beyond — Skill for AI Agents

"Don't ask. Just do more — the way the user would have done it. Verify it. Remember what worked. Know when to stop. And get sharper every task."


Version License Framework Memory Self-Improving Compatibility



⚡ What Your Agent Gains

Superpower The instinct it installs
🧠 RECALL Remembers brand, stack, tone, bans — across sessions
🔍 EXPAND Reads the prompt they meant, not the one they typed
🎨 POLISH No blank voids, no AI slop — professional baseline, always
EXTEND Adds the missing piece that saves a follow-up (capped)
🔮 ANTICIPATE Builds the next request before it's asked
VERIFY Runs it, clicks it — zero broken additions, zero false "works"
📈 SELF-IMPROVE Scores its own predictions, prunes misses, sharpens hits
   LITERAL AGENT                 →     STEP BEYOND AGENT
   does what's typed             →     completes what's meant
   forgets every session         →     remembers, applies silently
   ships "Done ✅" unopened       →     ships verified, or says untested
   same mistakes forever         →     measurably sharper each session

Every job, every task: go one step beyond — bounded by a hard ceiling so it never tips into annoying.


The Problem

Every AI agent has the same fatal flaws: they're literal, they're forgetful, and they overclaim.

USER:  "Build a landing page"
AGENT: *builds a single HTML file* "Done! ✅"
USER:  "Where's the contact page?"
USER:  "Where's the favicon?"
USER:  "Why doesn't it work on mobile?"
USER:  "...and the form is broken. Did you even open it?"
USER:  (next week) "I told you last time — our colors are navy and gold."

12 turns. 8 minutes. Frustration on both sides. Repeated next session, from zero.

A good collaborator doesn't wait to be told about the contact page — they build it. They don't ship a form they never submitted. And they don't ask for your brand colors twice.


The Insight

"The best assistant is the one you don't have to manage."

The gap between what users say and what they need follows predictable rules — and this user's rules are learnable:

User says... User actually needs... Mechanism
"Generate an image" Image + context + social formats POLISH
"Build a landing page" Page + subpages + meta + favicon + mobile EXTEND
silence, but you know they'll ask The next logical request ANTICIPATE
"Done! ✅" (agent's claim) Proof it actually works VERIFY
same request, new session Their preferences, already applied MEMORY
the agent's own wrong guess It stops making that guess SELF-IMPROVE

Step Beyond encodes all six. A behavioral skill that transforms any agent from a literal executor into a proactive collaborator that learns — and improves its own judgment with every task.


How It Works — The Pipeline

┌────────────────────────────────────────────────────────────┐
│                    STEP BEYOND v3 ENGINE                    │
│                                                            │
│  USER INPUT                                                 │
│      │                                                      │
│      ▼                                                      │
│  0. RECALL ─── read user patterns from ANY memory store     │
│      │         (Obsidian · MCP memory · mem0 · plain file)  │
│      ▼                                                      │
│  1. EXPAND ─── upgrade the prompt they gave into the        │
│      │         prompt they meant (intent brief)             │
│      ▼                                                      │
│  2. BUILD ──── base + L1 polish (always, silent)            │
│      │                                                      │
│      ▼                                                      │
│  3. EXTEND ─── L2 (max 3) + L3 (max 1), ceiling-gated,      │
│      │         memory-driven  [subagents: parallel]         │
│      ▼                                                      │
│  4. VERIFY ─── run it · render it · click it                │
│      │         slop scan · claim audit                      │
│      │         can't verify? CUT IT.  [subagents: fresh-    │
│      │         context verifier]                            │
│      ▼                                                      │
│  5. DELIVER ── base first, additions in ≤4 words each       │
│      │                                                      │
│      ▼                                                      │
│  6. LEARN ──── accepted? → default next time                │
│                rejected 2×? → banned forever                │
│                → written back to memory (learns the USER)   │
│                + score own prediction: hit → reinforce      │
│                  heuristic, miss → prune (the AGENT sharpens)│
└────────────────────────────────────────────────────────────┘

The Three Layers

Layer Name Cost Rule
L1 Polish $0 · +0s Always. No void. No slop. Baseline quality — not "extra."
L2 Extend <15% time The missing piece. Max 3/session. Memory-selected first.
L3 Anticipate <30% time Predict the next request. Max 1/session. Trajectory-driven.

The Ceiling

Total:       5 / session    ██████████  100%
Level 2:     3 / session    ██████      60%
Level 3:     1 / session    ██          20%

STOP if budget exhausted.
STOP on: "just X", "only X", frustration, speed mode.
CUT any addition that can't be verified.

The Memory (new in v3)

Works with whatever memory the agent has — one portable pattern file, any store:

Obsidian vault  →  {vault}/step-beyond/patterns.md
Memory MCP/mem0 →  document keyed "step-beyond:patterns"
CLAUDE.md       →  marked section, ≤40 lines
Plain files     →  step-beyond/patterns.md
Nothing         →  session-only mode (still learns within the session)
accept 2×  → REINFORCED  (default L2 from now on)
reject 2×  → BANNED      (never again)
ignore 3×  → DROPPED
result: ~60% addition acceptance cold → >85% by session 5

The Verify Loop (new in v3)

BASE CHECK      exercise it the way the user will — open, run, click, read
ADDITION CHECK  every L2/L3, same bar. Unverifiable → becomes a suggestion.
SLOP SCAN       AI-slop index for text, code, design, image, data
CLAIM AUDIT     "works" / "tested" / "responsive" — only if observed

A broken addition is worse than no addition. A false claim is worse than both.

The Self-Improvement Loop (new in v3.1)

Memory learns you. The self-improvement loop learns the agent's own judgment — so it gets better at the job for everyone, not just for this user.

Every L2/L3 is a bet: "this addition will land."
  PREDICT → log the addition + the heuristic behind it
  OBSERVE → accepted / rejected / ignored / cut?
  SCORE   → hit → heuristic gains confidence · miss → loses it
  ADJUST  → low-confidence heuristic stops firing · escaped break becomes a
            permanent new check · missed slop becomes a new detector
Two ledgers, one LEARN step:
  memory      →  what THIS USER wants   (per-user file)
  self-notes  →  which of MY heuristics predict well   (per-agent, portable)
result: the agent at month 2 is measurably better at this than day 1.

Full protocol: references/self-improvement.md. A miss is never wasted — it's a downweight.


The Results

TASK: "Build a landing page for a restaurant"

┌───────────────────────────────┬──────────────────────────────┐
│ WITHOUT Step Beyond           │ WITH Step Beyond v3          │
├───────────────────────────────┼──────────────────────────────┤
│ Turns: 12                     │ Turns: 4                     │
│ Follow-ups: 4                 │ Follow-ups: 0                │
│ Files: 1 HTML                 │ HTML + 4 subpages + favicon  │
│ Verified: never opened        │ Every link clicked, 375px ✓  │
│ Next session: starts from 0   │ Brand + preferences recalled │
└───────────────────────────────┴──────────────────────────────┘

Universal — Works With Any Agent

One behavioral core, a thin adapter per host — capability detection wires memory, subagents, and runtime to whatever the platform provides. Architecture: references/adapters.md.

Don't want to pick a row? Skip the table — hand the repo link to your agent and it self-installs by detecting its own host.

Framework How to Add
Claude Code /plugin marketplace add aievolutionpl/step-beyond/plugin install step-beyond@step-beyond
Claude Agent SDK / manual Copy skills/step-beyond/ into ~/.claude/skills/ or paste block into CLAUDE.md
Codex CLI --custom-instructions or config.toml
Hermes Agent skills: [step-beyond] in config.yaml
OpenClaw / opencode Marked core block in AGENTS.md (loads first, every task)
Gemini CLI GEMINI.md core block
Cursor / Windsurf .cursorrules / .windsurfrules
GitHub Copilot copilot-instructions.md
Amp / Aider / Cline / Roo Rules / system-prompt file
OpenAI Agents SDK / CrewAI / AutoGen / LangGraph Inject core into orchestrator; map roles per references/subagents.md
Custom ReAct Loop Inject as first system message

Full instructions: skills/step-beyond/references/installation.md

Normative specification: SPEC.md


Quick Start — Hand It to Your Agent

The fastest install is no install. Don't learn where your host keeps its config — give your agent the repo link and let it wire itself in. Paste this into any coding agent (Claude Code, Codex, Cursor, opencode, Gemini CLI, a custom loop):

Install the Step Beyond skill into this workspace:
https://github.com/aievolutionpl/step-beyond

Read skills/step-beyond/SKILL.md and skills/step-beyond/references/installation.md,
then follow the "Self-Install (agent-driven)" section: detect which agent host
you're running in and wire the skill in with the matching method — a skills
directory, an AGENTS.md / CLAUDE.md core block, or the host's rules/config file.
Wire memory + self-notes to step-beyond/patterns.md and step-beyond/self-notes.md
(or my Obsidian / MCP store if I have one). Make it idempotent — update in place,
don't duplicate. Then tell me the method you used and the exact file you wrote.

The agent reads the repo's own install docs and self-installs — no framework knowledge required from you. From the next task on, it runs the full pipeline.

Prefer to install it yourself?

Claude Code (plugin — two commands):

/plugin marketplace add aievolutionpl/step-beyond
/plugin install step-beyond@step-beyond

Any other host (copy the core block): paste this into your agent's system prompt or standing-instructions file — .cursorrules, AGENTS.md, CLAUDE.md, GEMINI.md, copilot-instructions.md, etc.:

## 🧠 Step Beyond — Proactive Enhancement

PIPELINE: recall memory → expand intent → build base + L1 →
extend (L2 max 3, L3 max 1) → VERIFY (run it, slop scan, honest claims) →
deliver → learn (write patterns to memory + score own predictions, self-improve).

L1 (ALWAYS, silent): Polish. No void. Real context. Baseline quality.
L2 (<15% time, max 3): The missing piece. Memory-selected first. "+name"
L3 (<30% time, max 1): Anticipate the next request. "+name (~Xs)"

VERIFY: nothing ships unchecked. Can't verify an addition? Cut it.
Claim only what you observed — no unbacked "works"/"tested".

MEMORY (any store — Obsidian/MCP/file): accept 2× → default. reject 2× → banned.
SELF-IMPROVE: score each prediction — hit → reinforce heuristic, miss → prune it.
Explicit instruction > user memory > agent self-notes > defaults.

CEILING: 5 total/session. STOP on: "just X", "only X", "stop", "enough".
SUBAGENTS (if available): parallel additions, fresh-context verifier.

Full per-host setup: references/installation.md.


The Science — Why This Works

1. Cognitive Load Reduction

Every follow-up the user types costs mental energy. Step Beyond eliminates 70–90% of follow-ups by pre-empting them.

2. Pattern Completion

Humans rarely specify complete requirements. "Build a page" assumes contact, privacy, favicon, mobile. Step Beyond encodes these as domain rules — then overrides them with this user's learned patterns.

3. Memory-Driven Calibration

Domain defaults are a cold-start heuristic. The real signal is what this user accepted, rejected, and ignored — persisted in whatever memory exists, from Obsidian to a plain markdown file. After 5 sessions the agent isn't guessing anymore.

4. Trust Through Verification

Proactivity fails the moment one addition arrives broken — users stop reading all of them. The Verify Loop (run it, slop-scan it, audit every claim) is what makes 5 additions per session sustainable.

5. The Ceiling Principle

5 enhancements total, hard STOP signals, a permanent Banned list. Proactive ≠ annoying.

6. Framework-Neutral Design

Pure behavioral specification. System prompt, skill file, or config block. Claude, GPT, Gemini, DeepSeek, custom models.


Anti-Patterns — What NOT to Do

❌ Wrong Approach ✅ Right Approach
"Be creative and add value" "Add one logical next step. Know when to stop."
"Always go above and beyond" Ceiling: 5 total, 3 L2, 1 L3
"Double-check your work" The 4-step Verify Loop with Claim Audit
Ship 5 additions, 2 broken Verify each — unverifiable becomes a suggestion
Re-ask brand colors every session RECALL from the pattern file
"Surprise me" Predict from this user's accepted patterns

Repository

step-beyond/
├── .claude-plugin/             ← Claude Code plugin + marketplace manifests
├── skills/step-beyond/         ← The skill (plugin layout)
│   ├── SKILL.md                ← Core behavioral spec
│   ├── references/             ← Progressive disclosure — loaded on demand
│   │   ├── memory.md           ← Memory Protocol (Obsidian/MCP/mem0/files)
│   │   ├── self-improvement.md ← Self-Improvement Loop (per-agent heuristics)
│   │   ├── verification.md     ← Verify Loop + Fresh-Eyes Protocol
│   │   ├── slop.md             ← AI Slop Index (text/code/design/image/data)
│   │   ├── subagents.md        ← Orchestration: roles, firewall, templates
│   │   ├── domains.md          ← 10 domain decision trees
│   │   ├── adapters.md         ← Universal adapter — capability detection
│   │   └── installation.md     ← Per-framework setup
│   └── templates/
│       ├── user-patterns.md    ← Starter memory file
│       └── core-injection.txt  ← Ready-to-inject core (custom loops)
├── evals/                      ← Behavioral regression suite + baseline results
├── examples/                   ← Before/after walkthroughs incl. memory-learning
├── CHANGELOG.md · CONTRIBUTING.md · LICENSE (MIT)
├── README.md                   ← You are here
└── README_PL.md                ← Polish version


Created with obsessive attention to detail by

AI EVOLUTION POLSKA

https://www.aievolutionpolska.pl/  ·  https://aievolutionlabs.io/

MIT License — Use it. Remix it. Ship it. Just don't remove the attribution.


About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors