Codex CLI's /plugin add accepts arbitrary git URLs and installs into
~/.codex/plugins/cache, not just OpenAI's curated catalog. Modeled the
manifest on Superpowers' .codex-plugin/plugin.json (skills field points
at ./skills/, interface block for UI metadata).
Bump both .claude-plugin/{plugin,marketplace}.json from 0.1.0 to 0.2.0
to signal Codex support.
README updated:
- Three install paths now: Claude Code plugin / Codex plugin / external spec
- Codex section explains the "no SessionStart hook" caveat — agents need
to invoke using-praxis manually on first turn (or get prompted by the
user)
Codex / Cursor users without plugin support continue to fall back to
the AGENTS.md / skills/ direct-read path documented in the next section.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
simgreek org requires login for git access, so anonymous /plugin
marketplace add fails. Members generate a Gitea access token (read-only
on repository) and embed it in the plugin URL. Token is stored in
Claude Code settings — documented as a caveat with revocation guidance.
Verified: token-embedded clone over HTTPS retrieves all .claude-plugin
manifest files and skills/.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Reframe team-guide as praxis (Greek for "practice"): Simgreek's coding
agent rulebook, distributed as a Claude Code plugin so SessionStart
hook can force-inject the using-praxis bootstrap.
- Add .claude-plugin/{marketplace,plugin}.json: makes this repo a
one-plugin marketplace installable via /plugin marketplace add.
- Add hooks/{hooks.json,session-start,run-hook.cmd}: SessionStart
hook reads using-praxis SKILL.md and injects it into context as
hookSpecificOutput.additionalContext (Claude Code) or
additional_context (Cursor) or additionalContext (Copilot CLI).
- Migrate library/<topic>/SPEC.md → skills/<topic>/SKILL.md with
YAML frontmatter (name + when-to-invoke description).
- Add skills/using-praxis: bootstrap with iron law, red-flags table,
catalog, instruction priority, sub-agent stop, Codex/Cursor fallback.
- Add skills/debugging: 4-phase root-cause investigation with
3-fixes-failed → architectural problem rule.
- Add skills/verification: evidence-before-claims gate with
rationalization table.
- Drop library/, references in AGENTS.md updated to skills/.
- Rename throughout: team-guide → praxis.
- README rewritten with both install paths (plugin / external spec)
and updated bootstrap prompt.
Codex / Cursor / non-Claude users still get the spec by reading
AGENTS.md and skills/ files manually — only the auto-injection
requires Claude Code.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Add a copy-pasteable prompt for humans to drop into Claude Code /
Codex when starting a new project. The prompt makes the AI fetch
team-guide, ask consolidated questions, scaffold project files
(AGENTS.md, CLAUDE.md, .gitignore, .gitattributes, .env.example,
README.md), and stop for confirmation before first commit.
Also covers the existing-project case (补规范) by swapping the
scaffolding step.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
8-phase AI execution sequence for Node.js / Next.js projects:
entry → frame → sync → edit → encoding → verify → commit → push
→ release. Phase 4 covers BOM / CRLF / non-UTF-8 detection and
fixes — these are the most common silent corruption when AI edits
files on Windows-default encoding systems.
- library/nodejs-project/SPEC.md (new)
- library/README.md catalog updated
- AGENTS.md §5 Team library entry list updated
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
team-guide is for AI to read at task start. Removed sections that
only describe human ceremonies and rewrote rules so AI can act on
them directly.
AGENTS.md:
- Replace §6 Planning cadence (Weekly/Quarterly/anti-Jira rhetoric)
with §6 Per-task spec — the only planning rule AI actually executes.
- §1 Vibe coding rewritten to be AI-actionable: explicit spec
requirement, observable stop-conditions (300-line / 5-file
thresholds), self-verification 6 steps phrased as AI behaviors.
- §2 Claude Code & Codex config compressed: each rule = decision +
one-line rationale, removed prose around skills/memory/sub-agents.
- §3 Git: drop branch owner-prefix rule, draft-PR rhythm, comment
etiquette. Keep PR description structure and reviewer 5-step.
Tag examples use <YYYYMMDD> placeholder so AI doesn't anchor on
a specific date.
- §Editing rules: drop snark ("No 🚀 Getting started! energy") that
could be misread; plain "No emoji".
- §Working directory: remove hardcoded "~10 files" count.
README.md:
- Drop "速查" cheatsheet (was for humans, redundant with AGENTS.md).
- Drop hardcoded tag examples (20260520).
- Trim positioning explanation in half.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
team-guide is now positioned as the external rulebook agents read at
project start: project AGENTS.md files reference team-guide rather
than duplicating its content.
- Delete templates/ (5 files). The only useful one — AGENTS.md
skeleton — is now an inline code block in AGENTS.md §2. Handoff
checklist also inlined into AGENTS.md §7.
- Remove the unaudited "Product projects" section (was AGENTS.md §5).
Project repos document their own release scheme in their own
AGENTS.md.
- Add library/ as a catalog for narrower specs.
- Seed library/git-upload/SPEC.md: what to commit / what not to,
.gitignore baseline, sensitive-info scan, leaked-secret recovery.
- AGENTS.md gets a "How AI agents use this repo" intro and a §5 Team
library section indexing library/.
- README.md updated to match: explicit "for AI" framing, library
section, drop product-spec mentions.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Single source of truth for AI is AGENTS.md. CLAUDE.md becomes a
one-line @AGENTS.md import so Claude Code and Codex read the same
spec — zero drift. README.md becomes a short Chinese entry point
(language policy, layout, tag styles, top pitfalls) and links into
AGENTS.md for full rules.
- Consolidate docs/01-08 into AGENTS.md (7 sections, ~700 lines)
- README.md: ~80-line Chinese entry point, no rule duplication
- CLAUDE.md: just "@AGENTS.md"
- Delete docs/ — content preserved in git history at tag 20260520-3
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Distill task_assistant's COLLABORATION_AND_RELEASE_WORKFLOW into a
team-wide product project spec and clarify when each tag style applies.
- Add docs/08-product-spec.md: semver triplet (internal/display/tag),
manifest schema, dist-channel separation, user-confirmed update
flow, feedback/log handling, sensitive-info scan, release flow,
minimum delivery checklist
- docs/03-git-workflow.md: split tagging into spec (YYYYMMDD) vs
product (vX.Y.Z) sections, link to 08
- README.md, CLAUDE.md, AGENTS.md: update versioning section and doc
index to reference 08
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Language policy: Chinese for human-facing files (README, docs/,
human-fillable templates), English for AI-facing files (CLAUDE.md,
AGENTS.md, AI templates). Commits / PRs / branches / tags stay
English.
- Translate docs/01-06 to Chinese
- Translate README.md, PR / handoff / project README templates to Chinese
- Drop README.en.md (redundant once language policy is explicit)
- Rewrite CLAUDE.md and CLAUDE.md.template under the new policy
- Add AGENTS.md (root) and templates/AGENTS.md.template for Codex
- Add docs/07-codex.md covering Codex usage and AGENTS.md / CLAUDE.md sync rules
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Move English README to README.en.md, add Chinese README.md as the entry point
- Cross-link both READMEs at the top
- Add Tagging section to docs/03-git-workflow.md (YYYYMMDD format,
immutable, annotated, daily-suffix collisions)
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Working agreements for our 1-3 person AI-assisted team. Six docs
(vibe coding, Claude Code, git workflow, skills/planning, code style,
handoff) plus four templates (CLAUDE.md, README, PR description,
handoff checklist).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>