docs(design): add the gear census note #296

targeting main from claude/gear-census-note
Merged opened by topos-backsword.test.pds.did.bot
targeting main from claude/gear-census-note

Adds design/gear.md, which lays out the gear design space from the maintainer's interview. Gear has three layers: a few to several dozen chassis, low hundreds of variants, and tens of thousands of modded combinations. All three are trait composition over the data model's kinds, properties and routes. Attachment points come in three kinds (ports, slots and mounts, with software slots and cores in the same model) and match by traits. Network exposure is kept separate from physical attachment.

The note treats safe networking as a first-class concern. Attack surface is derived from each networked part's doors and read by the same threat evaluation. It lists the threat sources (netrunners, ICE, facility hack-back) and mitigations, each with its cost. It also covers bulk and weight, upkeep with no essence or humanity budget, and a pack-validation invariant that every gear trait has a soft counter. Further sections cover clean versus exotic sources, identification tiers shared with enemy appraisal (knowledge is per runner), disposition reading, acquisition and loss, and lifepath starts.

It ends with a census of 13 placeholder capability families. Each is mapped to the systems that must read it, alongside what main can express today. equipment.md links to the new note. Docs only.

🤖 Generated with Claude Code

Commits 1

docs(design): add the gear census note
Sign up or Sign in to add to the discussion.