Skip to content

Latest commit

 

History

History
39 lines (28 loc) · 1.74 KB

File metadata and controls

39 lines (28 loc) · 1.74 KB

CLAUDE.md

Entry point for all agent types (Claude Code, Codex, Cursor, …); delegates to AGENTS.md via the @-import below. AGENTS.md is authoritative — edit it, not this file.


Snapshot (v1.1.0 · Go 1.26+ · single module)

github.com/spcent/plumego — a stdlib web toolkit for Go. Stable roots have zero runtime deps; x/* extensions may use external deps.

  • Stable roots (GA): core router contract middleware security store health log metrics — stdlib-only, no x/* imports
  • Extensions: 14 x/* (beta + experimental) — see AGENTS §3
  • Reference apps: reference/* (own go.mod); use-cases: workerfleet cloud-vault dbadmin guardus mini-saas-api (own go.mod)
  • CLI: cmd/plumego · Validation: internal/checks/ · Docs site: website/

Key commands

make validate-diff   # minimal gate for current diff (preferred)
make gates           # Go gates: vet, race tests, boundary checks, coverage ≥70%
make website-gates   # docs site: content/API checks + static build (slow)
make fmt             # gofmt -w (run before gates)
make website-sync    # regenerate website/src/generated/
make new-milestone N=NNN TITLE="..."     # scaffold milestone
make run-card C=active/NNNN-slug         # execute task card
make bundle TASK=<recipe> MODULE=<path>  # generate task bundle

Start here

  • Canonical shape: reference/standard-service (explicit middleware, routing, stdlib only)
  • Style: docs/reference/canonical-style-guide.md
  • Boundaries: each <module>/module.yaml + specs/dependency-rules.yaml
  • Task routing: specs/task-routing.yaml (task types → context packages + start files)
  • Active work: tasks/milestones/active/, tasks/cards/active/

@AGENTS.md