How wanshuiyin/hero-anti-overdefense works
HERO is a set of agent-workflow aids: persistent rules to keep work focused, Goal Pulse reminders to maintain momentum on an existing goal, and Session Handoff notes to preserve continuity between sessions. The principal workflow is an agent using the rules while doing work; for long goals, the optional pulse checks goal state and may send a reminder, and a handoff records evidence and a next action for a fresh session. README documentation supports the broader rules, host, and handoff branches; source detail is available only for Goal Pulse.
Main entry points: goal-pulse/SKILL.md Pulse Skill · goal_pulse.py Pulse Commands · RULES.md HERO Rules · session-handoff/SKILL.md Handoff Workflow
Components 12
Focus Rules
- HERO Rules
RULES.md - Supported Hosts
hosts/README.md - Behavior Cases
cases/README.md
Goal Pulse
- Pulse Skill
skills/goal-pulse/SKILL.md - Pulse Commands
skills/goal-pulse/scripts/goal_pulse.py - Reminder Loop
skills/goal-pulse/scripts/goal_pulse.py - Pulse State
skills/goal-pulse/scripts/goal_pulse.py
Session Handoff
- Handoff Workflow
skills/session-handoff/SKILL.md - Project Handoff Files
skills/session-handoff/README.md
Other components
- User
- Coding Agent
- Codex App Server
Connections 14
- User → HERO Rules: adds to config
README.md - HERO Rules → Coding Agent: guides work
README.md - Supported Hosts → HERO Rules: shows placements
README.md - Behavior Cases → Coding Agent: illustrates behaviors
README.md - User → Pulse Skill: installs optionally
README.md - Pulse Skill → Pulse Commands: configures timer
README.md - Pulse Commands → Codex App Server: uses JSON-RPC
skills/goal-pulse/scripts/goal_pulse.py - Pulse Commands → Reminder Loop: starts process
skills/goal-pulse/scripts/goal_pulse.py - Reminder Loop → Codex App Server: checks and steers
skills/goal-pulse/scripts/goal_pulse.py - Reminder Loop → Pulse State: records status
skills/goal-pulse/scripts/goal_pulse.py - Pulse Skill → Codex App Server: uses native loop
README.md - User → Handoff Workflow: starts handoff
README.md - Handoff Workflow → Project Handoff Files: records evidence
README.md - Project Handoff Files → Coding Agent: guides continuation
README.md