Tags
Cross-cutting clusters for rules, patterns, principles, and mechanisms. Tags avoid duplicating page type, review status, and compactness metadata.
Guidance tags
Code and API maintenance
Code shape, public contracts, dependencies, and reviewable change.
Change ShapeChange boundaries: what belongs together, what should split, and how much work one review should carry.68 itemsDependenciesThird-party code: selection, version bounds, updates, and downstream exposure.18 itemsModule LayoutModule and file placement, ownership, crate-root navigation, and public re-export paths.20 itemsOwnershipWhere behavior and state belong, and which module or layer should make the decision.38 itemsPublic APIInterfaces and behavior that callers may depend on across a crate or system boundary.70 itemsReader LocalityDefinitions, decisions, and use sites kept near enough that a change does not require a repository tour.91 itemsRefactoringInternal structural changes that should leave externally relevant behavior intact.10 itemsReleaseVersioning, package contents, support claims, and checks required before publication.12 itemsReviewabilityCode, prose, and proof arranged so a reviewer can find the decision and check it.107 itemsRustRust library and application practice, including idioms that do not transfer directly to other languages.104 items
Boundaries and reliability
Inputs, state, effects, failures, and runtime behavior.
AsyncTask spawning, scheduling, partial results, and failure behavior across asynchronous boundaries.7 itemsBoundary CorrectnessParsing, normalization, adapters, and policy where representations or systems meet.64 itemsErrorsError types and context carried between callers, layers, and user-facing surfaces.23 itemsFailure OutputWhat a user, test, or operator sees when work fails.25 itemsObservabilityLogs, diagnostics, and durable failure signals at the boundary that owns them.20 itemsSecurity PrivacySecrets, capabilities, unsafe code, diagnostic data, and other trust-boundary concerns.21 itemsSide EffectsWrites, network calls, process launches, and other work outside a pure computation.26 itemsState TransitionsValid states and the named transitions that move a system between them.22 itemsValidation PolicyWhich inputs are accepted, rejected, normalized, or allowed to fall back.31 items
Verification and performance
Evidence that behavior, compatibility, and performance claims hold.
PerformanceMeasured cost and latency, plus the benchmark discipline needed to justify an optimization.15 itemsTestingExecutable checks for contracts, edge cases, regressions, and useful failure messages.52 itemsVerificationEvidence for a claim: checks, inspection, measurements, or comparison with a trusted source.103 items
Documentation and conventions
Docs and examples, plus the sources and conventions used to check them.
AIWriting shaped with AI: generated-prose tells, checked claims, curation, and author ownership.7 itemsDocumentationREADME, guide, reference, and contract prose used to understand current behavior.111 itemsExamplesSmall uses that teach an API or prove an integration path.16 itemsLocal ConventionsEstablished repository rules and language idioms, followed consistently unless the work changes them.31 itemsRustdocRust API documentation as rendered and navigated by a crate user.20 itemsSource TruthThe implementation, primary source, or maintained artifact that settles a disputed claim.81 items
Agent and repository workflow
Context, tooling, automation, handoff, and version-control practice.
Agent ContextInstructions and durable project facts loaded for an agent's current task.45 itemsAgent WorkflowHow coding-agent work is scoped, executed, checked, and handed back.74 itemsAutomationChecks and maintenance run mechanically instead of being remembered each time.39 itemsFeedback LoopsFast checks, review cycles, and ways to turn repeated feedback into durable guidance.16 itemsGenerated ArtifactsFiles or behavior produced from another source: ownership, regeneration, validation, and promotion.5 itemsReview HandoffThe context and evidence another person needs to continue or judge the work.51 itemsToolingCommands and interfaces that make a preferred workflow repeatable.60 itemsVCS JJJujutsu working-copy, change, workspace, bookmark, remote, and recovery practice.39 items