Skip to content

Proposal 0007: Usage Rules for Beam Bots Packages#7

Open
jimsynz wants to merge 2 commits into
mainfrom
proposal/0007-usage-rules
Open

Proposal 0007: Usage Rules for Beam Bots Packages#7
jimsynz wants to merge 2 commits into
mainfrom
proposal/0007-usage-rules

Conversation

@jimsynz
Copy link
Copy Markdown
Contributor

@jimsynz jimsynz commented Jan 12, 2026

Summary

Add usage-rules.md files to published Beam Bots packages to provide AI coding assistants with authoritative, concise guidance for users building robots with BB.

This leverages the usage_rules hex package, enabling users to run:

mix usage_rules.docs bb              # View BB usage rules
mix usage_rules.docs bb_servo_robotis  # View servo driver rules

Key Points

  • Succinct documentation (~50-150 lines per package) that respects token budgets
  • References hexdocs/tutorials rather than duplicating content
  • Focuses on patterns and anti-patterns that AI assistants commonly get wrong
  • Covers all published bb_* packages (excluding example apps)

Packages Covered

  • Core: bb, bb_liveview, bb_kino, bb_reactor
  • IK solvers: bb_ik_dls, bb_ik_fabrik
  • Servo drivers: bb_servo_robotis, bb_servo_pca9685, bb_servo_pigpio, bb_servo_feetech

See the full proposal for the recommended file structure and example content.

Add usage-rules.md files to published BB packages to provide
AI coding assistants with authoritative guidance for users
building robots with the framework.
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.

1 participant