Commit Graph
11 Commits
Author SHA1 Message Date
Vinta ChenandClaude d4209ed39a docs: move website design rules into DESIGN.md
Website design rules were duplicated between AGENTS.md and DESIGN.md, and nothing pointed agents to DESIGN.md.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-19 13:17:14 +08:00
Vinta ChenandClaude abb48989d8 docs: refresh AGENTS.md source-of-truth and entry rules wording
AGENTS.md called README.md the single source of content truth though category intros live in website/data/category_intros/, and it repeated wording CONTRIBUTING.md already holds.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-19 13:17:14 +08:00
Vinta ChenandClaude 13570f9c23 docs: apply CONTRIBUTING.md when rewording an entry
The instruction to apply CONTRIBUTING.md covered only adding or removing an entry, so agents rewording an existing description skipped its rules, including the description length soft cap.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-10-19 13:06:47 +08:00
Vinta Chen 7fa334eb90 sync rules 2026-09-27 09:12:30 +08:00
Vinta ChenandClaude 66ac5fc775 docs: record 2026-08-23 audit sitting outcomes
Add a Stability Exceptions section to docs/audit-logs.md documenting
the zensical override (admitted pre-1.0 to displace a dying mkdocs
upstream). Add a matching evidence bullet to CLAUDE.md and AGENTS.md
warning that a download count is not automatically independent demand
when one listed entry depends on another, using mkdocs / mkdocs-material
as the worked example. Both facts were discovered during this sitting
and need to persist so the next audit doesn't rediscover them.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-23 00:50:17 +08:00
Vinta Chen d4fd148ba8 update wordings 2026-08-16 21:31:40 +08:00
Vinta ChenandClaude 24d6c2896b build: upgrade project to Python 3.14
watchdog 6.0.0 (last release 2024-11-01) ships no cp314 macOS wheel,
and uv has no per-package build allowlist under no-build = true, so
the preview file watcher moves to watchfiles, which ships cp314
wheels. watchfiles now lives in its own preview dependency group.
UV_PYTHON=3.13 is no longer needed on machines that only have 3.14.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 16:58:34 +08:00
Vinta ChenandClaude c6957d4c21 docs: require WebSearch evidence for tier judgments
Verifying keep/drop reasons with download counts alone isn't enough to judge obvious-choice vs challenger tiers; the maintainer requires WebSearch evidence of adoption trajectory and community sentiment too. Also rewrites the repo overview in CLAUDE.md and mirrors it to AGENTS.md per the kept-in-sync convention.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:52:03 +08:00
Vinta ChenandClaude bc3e7a08cd docs: condense AGENTS.md and CLAUDE.md for progressive disclosure
Trim repository overview and structure sections into a brief intro
plus focused Entry Rules and Gotchas sections, dropping restated
CONTRIBUTING.md content and Makefile/pyproject boilerplate.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 02:45:31 +08:00
Vinta ChenandClaude 59cc42e2c3 docs: sync AGENTS.md with the shortlist reform rules
AGENTS.md still carried pre-reform Key Rules (mandatory alphabetical
ordering, "quality over quantity" lanes-era language, no prune-sweep
commit exception, no live-verification rule). Bring it in line with
CLAUDE.md and CONTRIBUTING.md: downloads-descending tier ordering,
3+2 cap, sweep-commit exception, verification rule. Also record the
UV_PYTHON=3.13 workaround for Python-3.14-only machines in both files'
Makefile notes, and complete CLAUDE.md's Makefile target list.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-08-16 00:38:48 +08:00
Vinta Chen 79e0d8dc29 docs: add repository agent guidance 2026-05-27 15:41:37 +08:00