Skip to content

Go-public checklist: README with cockpit demo, LICENSE, contribution notes, publishing story #87

Description

@robercano

Context

The repo is private and will go public once ready. With the reCode rename done (#86) and the cockpit complete, this is the polish pass that makes the first public impression. Depends on #86 landing first so nothing ships under the old name.

Change

  • README: rewrite for an external reader who has never seen the project — what reCode is (orchestrated multi-agent development for Claude Code: PR loop, gates, worktree-isolated workers, cockpit), a 5-minute quickstart (install plugin → /orchestrator:setup → arm the loop), and a demo of the cockpit serve mode (GIF or annotated screenshot showing live workers + the inspector drawer).
  • LICENSE: add one (owner to choose; propose MIT as the default for dev tooling and flag the decision on this issue before committing).
  • CONTRIBUTING.md: how the self-hosted loop works here — issues are filed as backlog, only the owner labels planned, PRs go through the gate + reviewer-lens pipeline; what external contributors should and shouldn't touch (.claude/self/, MANAGED files).
  • Publishing story: document the supported install path (Claude Code plugin marketplace / git install), and record the npm-name situation (name squatted-dead; scope vs dispute options) so the decision is written down where a contributor can find it.
  • Hygiene sweep: confirm no secrets/tokens/personal paths in tracked files or issue templates; check .gitignore covers local-only files (.claude/state/, settings.local.json, editor dirs).

Done when

  • A stranger can go from the public README to a working orchestrated repo without reading the source.
  • LICENSE + CONTRIBUTING.md exist; hygiene sweep documented on this issue.
  • Owner has explicitly flipped visibility (out of scope for the loop — owner action).

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestmodule:docsUser-facing docsplannedOwner-approved for the autonomous loop (assigned ONLY by the owner)priority:highNext in line

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions