Skip to content

Add Anchor plugin (Community / Development & Workflow)#144

Open
biefan wants to merge 2 commits into
hashgraph-online:mainfrom
biefan:add-anchor
Open

Add Anchor plugin (Community / Development & Workflow)#144
biefan wants to merge 2 commits into
hashgraph-online:mainfrom
biefan:add-anchor

Conversation

@biefan
Copy link
Copy Markdown

@biefan biefan commented May 21, 2026

What this adds

Anchor under Community / Development & Workflow. Alphabetical insertion between AgentOps and Antigravity Workspace Template.

What Anchor is

A cross-CLI engineering-discipline pack for Claude Code and Codex CLI. One SKILL.md works for both runtimes (follows the agentskills.io standard).

Layer Mechanism
Skill (soft rules) SKILL.md — 7 core rules: clarify intent, task-scope locking, read project contracts, smallest-correct-diff, parallelize agents, condition-based codex review, pitfall writeback.
11 slash commands /ec /lock /pit /scan /done /next /recap /init-claude-md /status /ship /diff /cleanup
4 hooks (hard enforcement) SessionStart injects project state; Stop blocks "stop" in autonomous mode while tasks remain; PreToolUse blocks irreversible bash patterns; PostToolUse runs the language-appropriate linter after Edit/Write.

Optional autonomous mode (toggle file ~/.claude/.efficient-coding-autonomous) makes the Stop hook block until the task list is fully cleared — useful for "do this whole thing, don't stop" sessions.

Bundle structure (matches CONTRIBUTING.md)

plugins/biefan/anchor/
├── .codex-plugin/plugin.json   # name + version 1.3.2 + license MIT + interface.composerIcon + keywords
├── assets/icon.svg             # 711 bytes, 512x512, simple anchor mark
├── LICENSE                     # MIT (copy of the upstream's LICENSE)
└── README.md                   # Anchor summary + installation pointer to the full upstream

The bundle is a mirror entry; the full repo (hooks/, scripts/, references/, evals/, CI, install.sh) lives at https://github.com/biefan/anchor and is the source of truth.

Validation

  • CI green for 6+ consecutive runs (shellcheck on every .sh, jsonlint on every .json, install-smoke runs ./install.sh on a clean Ubuntu container, verifies file landing, then runs ./uninstall.sh and verifies cleanup).
  • Stress test Add oc-chatgpt-multi-auth to community plugins #3 (debug failing tests via observe-hypothesize-verify) scored 6 pass / 1 fail / 1 N/A via the project's own codex-as-judge auto-grader (evals/stress/grade.py). The agent correctly used the hypothesis-verify protocol, wrote both required pitfall entries to project-level CLAUDE.md in the 4-field template, and made the right fixes without sneaking in "improvements".
  • Two earlier evals (stress Add Langfuse Observability to Tools & Integrations #2 refactor; 5 short-Q&A evals in evals/run.py) are also archived under evals/results/ in the upstream.

PR Checklist

  • README.md entry is alphabetically sorted within Community / Development & Workflow
  • Plugin bundle exists under plugins/biefan/anchor/
  • .codex-plugin/plugin.json exists and is valid JSON (python3 -m json.tool)
  • composerIcon is set in plugin.json interface section (./assets/icon.svg)
  • Icon file exists at the path referenced by composerIcon (711 bytes, 512x512)
  • All links in the README entry are valid
  • No placeholder or TODO values in plugin.json

Happy to adjust the description / category / icon if maintainers want changes.

biefan added 2 commits May 21, 2026 09:14
Anchor is a cross-CLI (Claude Code + Codex CLI) engineering-discipline pack
that bundles a skill, 11 slash commands, and 4 safety hooks. Highlights:

- task-scope anchoring on the user's exact phrasing
- anti-drift braking when the model tries to go out of scope
- optional autonomous mode (Stop hook keeps the model going while tasks remain)
- end-to-end verification gate (refuses to declare done before a real E2E)
- multi-pass vulnerability scanning + condition-based codex review on big diffs
- pitfall writeback to the project's CLAUDE.md
- PreToolUse hook blocking irreversible bash patterns (hard-reset, force-push,
  schema-level drops, mkfs, dd-to-device, recursive-777, curl-pipe-bash) with
  a shell-aware segment + safe-list parser so echo/grep literals don't false-trip

Bundle:
- plugins/biefan/anchor/.codex-plugin/plugin.json  (name, version 1.3.1,
  license MIT, interface.composerIcon, keywords)
- plugins/biefan/anchor/assets/icon.svg            (711 bytes, 512x512)
- plugins/biefan/anchor/LICENSE                    (MIT)
- plugins/biefan/anchor/README.md                  (points at the full repo)

README entry inserted alphabetically between AgentOps and Antigravity.

Upstream:  https://github.com/biefan/anchor
Release:   https://github.com/biefan/anchor/releases/tag/v1.3.1
License:   MIT
CI:        green (shellcheck + jsonlint + install.sh smoke test)
@@ -0,0 +1,29 @@
{
"name": "anchor",
"version": "1.3.2",
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CRITICAL: Version mismatch — plugin.json declares "version": "1.3.2", but plugins/biefan/anchor/README.md line 6 states Release tag: v1.3.1. These must match.

@@ -0,0 +1,37 @@
# Anchor

Engineering discipline pack for Claude Code & Codex CLI: a skill + 11 slash commands + 4 safety hooks that keep AI on-task on long tasks, enforce E2E verification, multi-pass vulnerability scanning, condition-based codex review, and project-CLAUDE.md pitfall writeback.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CRITICAL: Contradictory slash-command counts — this line describes "a skill + 11 slash commands", but line 19 below states the install script copies "the skill + 7 commands". Either the count or the underlying description is wrong.

@@ -0,0 +1,37 @@
# Anchor

Engineering discipline pack for Claude Code & Codex CLI: a skill + 11 slash commands + 4 safety hooks that keep AI on-task on long tasks, enforce E2E verification, multi-pass vulnerability scanning, condition-based codex review, and project-CLAUDE.md pitfall writeback.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CRITICAL: Stray closing bold marker at end of first paragraph — one voice.** has two ** closures on a single span. Remove the extra ** or apply bold markup correctly.

@kilo-code-bot
Copy link
Copy Markdown

kilo-code-bot Bot commented May 21, 2026

Code Review Summary

Status: 3 Issues Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 3
WARNING 0
SUGGESTION 0
Issue Details (click to expand)

CRITICAL

File Line Issue
plugins/biefan/anchor/.codex-plugin/plugin.json 3 Version mismatch — plugin.json declares "version": "1.3.2", but plugins/biefan/anchor/README.md line 6 states Release tag: v1.3.1. These must match.
plugins/biefan/anchor/README.md 3 Contradictory slash-command counts — this line describes "a skill + 11 slash commands", but line 19 states the install script copies "the skill + 7 commands". Either the count or the underlying description is wrong.
plugins/biefan/anchor/README.md 3 Stray closing bold marker at end of first paragraph — one voice.** has two ** closures on a single span. Remove the extra ** or apply bold markup correctly.
Other Observations (not in diff)
  • plugins/biefan/anchor/README.md line 19 comments that install.sh copies "7 commands" — this is a stale figure: 11 slash commands are documented in the table (/ec /lock /pit /scan /done /next /recap /init-claude-md /status /ship /diff /cleanup). Update line 19 to reflect the actual command count. This line is not currently in the diff and cannot receive an inline comment, but the inconsistency should be resolved regardless.
  • README.md (project root) line 126: the Anchor description between biek-case tiles could be improved for consistency with the pattern used by nearby plugins (clarity, style conventions).
Files Reviewed (5 files)
  • README.md — 1 observation (link added, no inline issue flagged)
  • plugins/biefan/anchor/.codex-plugin/plugin.json — 1 issue (version mismatch)
  • plugins/biefan/anchor/README.md — 2 inline issues + 1 off-diff observation (version tag, command count, stray bold marker)
  • plugins/biefan/anchor/LICENSE — no issues
  • plugins/biefan/anchor/assets/icon.svg — no issues

Reviewed by step-3.5-flash · 191,566 tokens

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds the 'Anchor' plugin, an engineering discipline pack for Claude Code and Codex CLI, including its manifest, documentation, and assets. The review identifies that the skills field is missing from the plugin manifest and suggests updating the link in the main README to point to the local directory for consistency with other plugins.

},
"homepage": "https://github.com/biefan/anchor",
"repository": "https://github.com/biefan/anchor",
"license": "MIT",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The skills field is missing from the manifest. According to the "Plugin Anatomy" section in the root README.md (line 233), the skills path is a required field. For the plugin to be functional when installed via the Codex marketplace, this field must be present and point to the skill definitions (e.g., a ./skills directory containing SKILL.md).

  "license": "MIT",
  "skills": "./skills",

Comment thread README.md
- [Aegis](https://github.com/GanyuanRan/Aegis) - An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.
- [Agentizer](https://github.com/Humiris/wwa-transform) - Turn any website into an AI-powered agentfront with split-pane
- [AgentOps](https://github.com/boshu2/agentops) - DevOps layer for coding agents with flow, feedback, and memory that compounds between sessions.
- [Anchor](https://github.com/biefan/anchor) - Engineering discipline pack for Claude Code & Codex CLI with task-scope locking, anti-drift braking, condition-based codex review, project-CLAUDE.md pitfall writeback, and PreToolUse hooks that block irreversible bash patterns.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The link for "Anchor" points to the external repository. Since a local plugin bundle has been provided in plugins/biefan/anchor/, the link should point to the local directory to remain consistent with other mirrored plugins (e.g., "Changelog Forge") and to ensure the local metadata and icon are used by the marketplace.

Suggested change
- [Anchor](https://github.com/biefan/anchor) - Engineering discipline pack for Claude Code & Codex CLI with task-scope locking, anti-drift braking, condition-based codex review, project-CLAUDE.md pitfall writeback, and PreToolUse hooks that block irreversible bash patterns.
- [Anchor](./plugins/biefan/anchor) - Engineering discipline pack for Claude Code & Codex CLI with task-scope locking, anti-drift braking, condition-based codex review, project-CLAUDE.md pitfall writeback, and PreToolUse hooks that block irreversible bash patterns.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 58d0173ef1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Engineering discipline pack for Claude Code & Codex CLI: a skill + 11 slash commands + 4 safety hooks that keep AI on-task on long tasks, enforce E2E verification, multi-pass vulnerability scanning, condition-based codex review, and project-CLAUDE.md pitfall writeback.

- **Upstream repo**: https://github.com/biefan/anchor
- **Release tag**: v1.3.1
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Align README release tag with bundled plugin version

The bundle metadata advertises version 1.3.2 in .codex-plugin/plugin.json, but this README still states v1.3.1 as the release tag (and later references release notes through v1.3.1). That inconsistency makes it unclear which upstream release this mirror corresponds to and can mislead maintainers/users when validating or reproducing installs.

Useful? React with 👍 / 👎.

Comment thread README.md
- [Aegis](https://github.com/GanyuanRan/Aegis) - An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.
- [Agentizer](https://github.com/Humiris/wwa-transform) - Turn any website into an AI-powered agentfront with split-pane
- [AgentOps](https://github.com/boshu2/agentops) - DevOps layer for coding agents with flow, feedback, and memory that compounds between sessions.
- [Anchor](https://github.com/biefan/anchor) - Engineering discipline pack for Claude Code & Codex CLI with task-scope locking, anti-drift braking, condition-based codex review, project-CLAUDE.md pitfall writeback, and PreToolUse hooks that block irreversible bash patterns.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Regenerate marketplace artifacts after adding README plugin entry

This commit adds Anchor to README.md but does not update plugins.json or .agents/plugins/marketplace.json, so the new plugin will not appear in the curated marketplace metadata consumed by local installs and legacy tooling. The repository’s own contribution/CI flow expects these artifacts to stay in sync with README changes, so this addition is incomplete until the generated files are refreshed.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant