agent-engineering

Defines engineering principles and workflow rules for AI coding agents.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill agent-engineering-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-engineering
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/agent-engineering
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill agent-engineering-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding agents often repeat the same mistakes, lose track of goals during long sessions, and mark tasks complete without verification. This Skill provides a structured set of engineering principles that make agent behavior more consistent, verifiable, and self-improving. ## Core Features & Use Cases - Plan-First Workflow: Enforces plan mode for non-trivial tasks with checkable items tracked in tasks/todo.md. - Self-Improvement Loop: Converts every user correction into a permanent rule in tasks/lessons.md so mistakes are not repeated. - Subagent Delegation & Verification Gates: Guides when to offload work to subagents and requires test evidence before marking tasks done. - Use Case: When writing an AGENTS.md or CLAUDE.md for a new repository, apply these principles to define the agent's planning, verification, and lesson-capture standards from day one. ## Quick Start Ask the agent to draft an AGENTS.md file for your project using these engineering principles, including a verification checklist and a lessons-file convention.

Frequently Asked Questions about agent-engineering

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

FAQPage Schema
How do I write an AGENTS.md file for my project?

Start with engineering standards covering planning, verification, and lesson capture. Include a before-starting checklist (read lessons, plan in todo.md), working rules (one task per subagent), and a done checklist (run tests, review diff) tailored to your stack.

How to stop an AI coding agent from repeating mistakes?

Maintain a lessons file where every user correction becomes a permanent rule with a trigger and a fix. Have the agent review relevant lessons at session start so the feedback loop closes and mistake rates drop over time.

When should an AI agent use subagents instead of working inline?

Use subagents for research spanning many files, independent parallel work, long-running builds, or risky experiments. Do simple single-file edits, quick config changes, and trivial refactors inline to avoid unnecessary overhead.

What is a verification gate for AI coding agents?

A verification gate requires proof that changes work before a task is marked done. The agent runs tests, checks logs, smoke-tests the changed code path, and reviews the diff for unintended changes instead of assuming correctness.

Does this workflow apply to Claude Code and Cursor agents?

Yes, the principles are tool-agnostic and map to AGENTS.md, CLAUDE.md, and CURSOR.md configuration files. Any agent that reads project-level instruction files can adopt the planning, delegation, and verification conventions.