zoahdev · zoahdev · Aug 29, 2026
diff --git a/.github/ISSUE_TEMPLATE/community-task.yml b/.github/ISSUE_TEMPLATE/community-task.yml
@@ -0,0 +1,73 @@
+name: Community task
+description: Propose or claim a bounded, publicly reviewed community deliverable
+title: "[Community task]: "
+labels: ["community", "help wanted"]
+body:
+  - type: dropdown
+    id: working_group
+    attributes:
+      label: Working group
+      options:
+        - Protocol and interoperability
+        - Implementations and hardware
+        - Security and adversarial testing
+        - Documentation and translation
+        - Deployments and user research
+        - Governance and community operations
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem and public value
+      description: What concrete problem does this solve, and for whom?
+    validations:
+      required: true
+  - type: textarea
+    id: deliverable
+    attributes:
+      label: Bounded deliverable
+      description: Define a result that can normally be completed within two weeks.
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance test
+      description: What observable evidence proves the task is complete?
+    validations:
+      required: true
+  - type: input
+    id: work_location
+    attributes:
+      label: Public work location
+      description: Link a branch, repository, discussion, issue, or draft if one exists.
+  - type: textarea
+    id: safety
+    attributes:
+      label: Safety, privacy, compatibility, and licensing boundaries
+      description: State any hardware hazards, private data, compatibility effects, and licensing constraints.
+    validations:
+      required: true
+  - type: dropdown
+    id: relationship
+    attributes:
+      label: Compensation status
+      description: Open-source contribution does not imply employment or future payment.
+      options:
+        - Volunteer open-source contribution; no compensation promised
+        - Separately funded work exists and will be documented outside this issue
+    validations:
+      required: true
+  - type: checkboxes
+    id: commitments
+    attributes:
+      label: Contributor commitments
+      options:
+        - label: I will work publicly except for responsibly disclosed security details.
+          required: true
+        - label: I understand that contribution credentials are non-financial and non-transferable.
+          required: true
+        - label: I will not test on hazardous machinery without the operator's authorization and safety controls.
+          required: true
+
diff --git a/.github/ISSUE_TEMPLATE/community-vote.yml b/.github/ISSUE_TEMPLATE/community-vote.yml
@@ -0,0 +1,51 @@
+name: Community vote
+description: Open a public governance vote after the required comment period
+title: "[Vote]: "
+labels: ["governance", "vote"]
+body:
+  - type: input
+    id: proposal
+    attributes:
+      label: Proposal or election
+      description: Link the RFC, nomination, recall motion, or maintainer proposal.
+    validations:
+      required: true
+  - type: input
+    id: comment_window
+    attributes:
+      label: Completed comment window
+      description: Give the start and end dates and link the public discussion.
+    validations:
+      required: true
+  - type: input
+    id: voting_window
+    attributes:
+      label: Voting window
+      description: Give UTC opening and closing timestamps; RFC-0005 proposes at least seven days.
+    validations:
+      required: true
+  - type: textarea
+    id: eligibility
+    attributes:
+      label: Eligible voter registry snapshot
+      description: Link an immutable commit containing the eligible-member list.
+    validations:
+      required: true
+  - type: textarea
+    id: ballot
+    attributes:
+      label: Ballot instructions
+      value: |
+        Comment with exactly one position: APPROVE, REJECT, or ABSTAIN.
+        Add a short rationale and disclose conflicts of interest (or write "none").
+        One natural person may cast one vote. Edited votes must retain a visible correction note.
+    validations:
+      required: true
+  - type: checkboxes
+    id: administrator
+    attributes:
+      label: Vote administrator declaration
+      options:
+        - label: I have no undisclosed conflict and will publish the exact tally, invalid ballots, quorum result, and minority rationale.
+          required: true
+
diff --git a/COMMUNITY.md b/COMMUNITY.md
@@ -1,24 +1,35 @@
-# KineGrant Community
-
-KineGrant is an open, community-governed project. Community hub:
-https://kinegrant.com/community (中文：https://kinegrant.com/zh/community)
-
-## Governance model
-
-No-token DAO-style governance: community ownership, transparent decision
-records, and open participation — with **no financial mechanism**.
+# KineGrant Community
+
+KineGrant is an open, community-governed project. Community hub:
+https://kinegrant.com/community (中文：https://kinegrant.com/zh/community)
+
+## Governance model
+
+No-token DAO-style governance: community ownership, transparent decision
+records, and open participation — with **no financial mechanism**.
+
+- Charter: [docs/community/CHARTER.md](docs/community/CHARTER.md)
+- Protocol charter: [GOVERNANCE.md](GOVERNANCE.md)
+- RFC process: [docs/RFC-PROCESS.md](docs/RFC-PROCESS.md)
+- Decision log: [docs/community/DECISION-LOG.md](docs/community/DECISION-LOG.md)
+- Contribution credentials: [docs/community/CONTRIBUTION-CREDENTIALS.md](docs/community/CONTRIBUTION-CREDENTIALS.md)
+- Compliance boundaries: [docs/community/COMPLIANCE.md](docs/community/COMPLIANCE.md)
+- Code of conduct: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+
+## How to join
 
-- Charter: [docs/community/CHARTER.md](docs/community/CHARTER.md)
-- Protocol charter: [GOVERNANCE.md](GOVERNANCE.md)
-- RFC process: [docs/RFC-PROCESS.md](docs/RFC-PROCESS.md)
-- Decision log: [docs/community/DECISION-LOG.md](docs/community/DECISION-LOG.md)
-- Contribution credentials: [docs/community/CONTRIBUTION-CREDENTIALS.md](docs/community/CONTRIBUTION-CREDENTIALS.md)
-- Compliance boundaries: [docs/community/COMPLIANCE.md](docs/community/COMPLIANCE.md)
-- Code of conduct: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+1. Start with [Build KineGrant with us](docs/community/BUILD-WITH-US.md)
+   ([中文](docs/community/BUILD-WITH-US.zh-CN.md)).
+2. Read [CONTRIBUTING.md](CONTRIBUTING.md).
+3. Pick a bounded community task, reproduce the Machine Permission Test,
+   review an open RFC, or start a permissionless working group with one other
+   participant.
+4. Open a pull request. Merged work is credited publicly and non-financially.
 
-## How to join
+## Democratic transition proposal
 
-1. Read [CONTRIBUTING.md](CONTRIBUTING.md).
-2. Pick a good-first issue, reproduce the Machine Permission Test, review an
-   open RFC, or propose an adapter.
-3. Open a pull request. Merged work is credited publicly and non-financially.
+[KGP-RFC-0005](docs/rfcs/0005-one-person-one-vote-governance.md)
+([中文](docs/rfcs/0005-one-person-one-vote-governance.zh-CN.md)) proposes equal
+one-person-one-vote membership, an elected and recallable council, no founder
+veto, permissionless working groups, and a narrow, reviewable emergency-security
+path. It is a draft until the existing RFC process accepts it.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -1,26 +1,32 @@
-# Contributing to KineGrant
-
-KineGrant is an experimental open draft. Contributions should improve precise,
-testable interoperability—not expand the project into a general robot platform.
-
+# Contributing to KineGrant
+
+KineGrant is an experimental open draft. Contributions should improve precise,
+testable interoperability—not expand the project into a general robot platform.
+
 ## Good first contributions
-
-- turn an ambiguous KGP-001 sentence into a deterministic rule and test;
-- add negative tests for tampering, replay, confused-deputy, or downgrade cases;
-- identify where an adapter could silently widen permission;
-- propose a persistent replay or revocation interface;
-- build an independent verifier in another language;
+
+- turn an ambiguous KGP-001 sentence into a deterministic rule and test;
+- add negative tests for tampering, replay, confused-deputy, or downgrade cases;
+- identify where an adapter could silently widen permission;
+- propose a persistent replay or revocation interface;
+- build an independent verifier in another language;
 - document a cross-device simulation without controlling hazardous machinery.
 
-## Pull-request requirements
-
-1. Explain the security property or interoperability problem.
-2. Add or update tests for normative behavior.
-3. State compatibility and privacy impact.
-4. Do not claim certification by W3C, IEEE, CSA, OPC Foundation, or ROS.
-5. Keep the real-time action path ledger-independent.
-
-Normative changes should be proposed as a numbered KGP draft or an issue marked
-`protocol-change`. Editorial and implementation-only changes may use a normal
-pull request. By contributing, you agree that your contribution is licensed
-under Apache-2.0.
+For bounded two-week tasks and permissionless working groups, see
+`docs/community/BUILD-WITH-US.md` (中文：
+`docs/community/BUILD-WITH-US.zh-CN.md`) or open the **Community task** issue
+form. Two participants may start a public working group without prior approval;
+its output follows the normal review and RFC rules.
+
+## Pull-request requirements
+
+1. Explain the security property or interoperability problem.
+2. Add or update tests for normative behavior.
+3. State compatibility and privacy impact.
+4. Do not claim certification by W3C, IEEE, CSA, OPC Foundation, or ROS.
+5. Keep the real-time action path ledger-independent.
+
+Normative changes should be proposed as a numbered KGP draft or an issue marked
+`protocol-change`. Editorial and implementation-only changes may use a normal
+pull request. By contributing, you agree that your contribution is licensed
+under Apache-2.0.
diff --git a/README.md b/README.md
@@ -39,15 +39,15 @@ reproducible evidence — is the technical body that backs this up.*
 
 **Try it now, no install:** run the [one-click demo](https://kinegrant.com/playground.html), or open the [offline browser verifier](https://zoahdev.github.io/verify/policy-bundle-verifier.html) — signed bundles, capabilities, delegation chains, forbidden combinations, receipts, MPT evidence, fleet operations, hardware evidence and more are all verified locally in your browser. If KineGrant is useful to you or your team, **give this repo a ⭐** — it helps independent reviewers and robot vendors find the project.
 
-**Contributing:** read [CONTRIBUTING.md](CONTRIBUTING.md) and pick a [good first issue](https://github.com/zoahdev/kinegrant-protocol/labels/good%20first%20issue) — translations, linter setup, documentation, adapters, and independent implementations are all welcome. New here? Ask anything in [Discussions](https://github.com/zoahdev/kinegrant-protocol/discussions).
+**Contributing:** start with [Build KineGrant with us](docs/community/BUILD-WITH-US.md) ([中文](docs/community/BUILD-WITH-US.zh-CN.md)), then pick or propose a bounded [community task](https://github.com/zoahdev/kinegrant-protocol/issues/new/choose). Translations, documentation, adapters, hardware evidence, security reviews, and independent implementations are welcome. New here? Ask anything in [Discussions](https://github.com/zoahdev/kinegrant-protocol/discussions).
 
 ## Community and governance
 
 KineGrant is community-governed under a no-token DAO-style model: transparent RFC decisions, contribution-based roles, public records, and **no financial mechanism** — no tokens, no fundraising, no legal entity, and no unsolicited outreach. See [COMMUNITY.md](COMMUNITY.md), [docs/community/](docs/community/), the [steering-committee seat guide](docs/community/STEERING-COMMITTEE.md) ([中文](docs/community/STEERING-COMMITTEE.zh-CN.md)), the [community charter](docs/community/CHARTER.md) ([中文](docs/community/CHARTER.zh-CN.md)), the [participation guide](docs/community/PARTICIPATION.md), the [RFC voting guide](docs/community/RFC-VOTING.md), the [seat nomination template](docs/community/NOMINATION-TEMPLATE.md), and the [pilot partnership framework](docs/PILOT-PARTNERSHIP.md).
 
 Community hub: https://kinegrant.com/community · 中文社区：https://kinegrant.com/zh/community
 
-> **Governance now:** RFC-0003 acceptance vote is open until 2026-08-29 ([issue #127](https://github.com/zoahdev/kinegrant-protocol/issues/127)); external advisory votes are welcome. See [RFC-VOTING.md](docs/community/RFC-VOTING.md).
+> **Democratic transition:** [RFC-0005](docs/rfcs/0005-one-person-one-vote-governance.md) ([中文](docs/rfcs/0005-one-person-one-vote-governance.zh-CN.md)) proposes equal member votes, an elected and recallable council, no founder veto, and permissionless working groups. It remains a draft until accepted through the current RFC process.
 
 ## Quick start (30 seconds)