Skip to content

rules: add shared agent-consumers policy (closes #7) - #8

Merged
shinaoka merged 2 commits into
mainfrom
codex/issue-7-agent-consumers
Aug 8, 2026
Merged

rules: add shared agent-consumers policy (closes #7)#8
shinaoka merged 2 commits into
mainfrom
codex/issue-7-agent-consumers

Conversation

@shinaoka

@shinaoka shinaoka commented Aug 8, 2026

Copy link
Copy Markdown
Member

Summary

Adds rules/common/agent-consumers.md: shared policy for the repository work that serves downstream users and coding agents of user-facing tensor4all libraries, per #7. Also links it from rules/index.md and extends the loading policy.

The four policies are distilled from the implementations that landed in tenferro-rs (tensor4all/tenferro-rs#1625, tensor4all/tenferro-rs#1632, tensor4all/tenferro-rs#1633, tensor4all/tenferro-rs#1634, tensor4all/tenferro-rs#1635), so each one is stated with the check that guards it rather than as aspiration:

  1. Downstream-usage skill: bundled in-repo, linked from README (reachable from the package registry landing page), snippets CI-verified, freshness enforced by a pre-PR checklist item.
  2. Remedy clauses in errors: <what failed>; <what to do> when one documented remediation exists, with the explicit counter-rule not to invent remedies for open-ended failures (wording follows tenferro's REPOSITORY_RULES.md).
  3. Package-index metadata gate: keywords/categories/MSRV/doc-build config required by a pre-publish check, including the docs.rs feature-visibility trap.
  4. Verified llms.txt: generated from the site manifest where possible, otherwise guarded by an existence/coverage check.

A fifth section cross-references the existing source-blind build test in docs-and-tests.md as the validation method, per the issue's acceptance criteria.

Consumer repos with open counterpart work: tensor4all/tensor4all-rs#573, tensor4all/tensor4all-rs#577-580.

Closes #7

🤖 Generated with Claude Code

…aries

Adds rules/common/agent-consumers.md distilling the enforcement patterns
proven in tenferro-rs (PRs #1625, #1632-#1635): bundled downstream-usage
skills with a pre-PR freshness gate, remedy clauses in error messages,
pre-publish package-index metadata checks, and verified llms.txt indexes.
Links the file from rules/index.md and extends the loading policy.

Closes #7

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@shinaoka
shinaoka merged commit c6221a7 into main Aug 8, 2026
1 check passed
@shinaoka
shinaoka deleted the codex/issue-7-agent-consumers branch August 8, 2026 18:08
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.

Add shared rules for agent consumers of tensor4all libraries (rules/common/agent-consumers.md)

1 participant