Skip to content

Open-source readiness: MIT LICENSE + README rewrite (Phase 12)#32

Merged
drabaioli merged 5 commits into
mainfrom
opensource_readme_license
Jun 23, 2026
Merged

Open-source readiness: MIT LICENSE + README rewrite (Phase 12)#32
drabaioli merged 5 commits into
mainfrom
opensource_readme_license

Conversation

@drabaioli

Copy link
Copy Markdown
Owner

Summary

Phase 12 — prepare CDD to be open-sourced publicly.

  • LICENSE — standard MIT, repo root only (holder: Diego Andres Rabaioli, 2026). Deliberately not added to template/ or wired into bootstrap-cdd-project.sh: the template is copied verbatim into downstream projects, which shouldn't drag CDD's license along.
  • README rewrite — leads with the guided entry points (/cdd-bootstrap, /cdd-retrofit, /cdd-quick-create), keeps the manual bootstrap-cdd-project.sh recipe below; a full reference table of all 7 slash commands; replaces the two Mermaid diagrams with the doc/assets/task-cycle.png task-cycle image; adds an issues-only Contributing section and a License section. Two-big-ideas framing, six-checkpoint concept, template-smoke badge, and Status section retained.
  • Roadmap — adds Phase 12, ticks the two completed items, and tracks remaining OSS essentials (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, issue templates, repo metadata, public repo home confirmation).
  • Pre-PR reconciliationdoc/architecture/overview.md now lists LICENSE in the top-level layout tree.

Verification

  • bash -n over all scripts: clean
  • scripts/command-drift-check.sh: command-set drift clean
  • All README relative links resolve; PNG asset valid (1786×381)
  • Confirmed LICENSE is repo-root only: absent from template/, unreferenced by the bootstrap script
  • No upstream drift

Docs/license-only change — no behavioral code, so no new tests (recorded intentional).

🤖 Generated with Claude Code

drabaioli and others added 5 commits June 22, 2026 20:21
Add a root MIT LICENSE (holder: Diego Andres Rabaioli, 2026), repo-root
only — not added to template/ or wired into bootstrap-cdd-project.sh, since
the template is copied verbatim into downstream projects.

Rewrite the README from scratch: lead the quick start with the guided
commands (/cdd-bootstrap, /cdd-retrofit, /cdd-quick-create) and demote the
manual bootstrap recipe; add a complete 7-command reference; replace the
mermaid lifecycle diagram with the task-cycle image (doc/assets/task-cycle.png);
remove the "what's in this repo" mermaid diagram; add a short issues-only
Contributing section. Kept the two-big-ideas framing, the six-checkpoint
concept, the template-smoke badge, and the Status section.

Seed roadmap Phase 12 (Open-source readiness): LICENSE and README checked;
CONTRIBUTING.md, CODE_OF_CONDUCT.md, .github/ templates, SECURITY.md, repo
metadata, and public-repo-home/URL finalization left as tracked items.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The Phase 12 change added a repo-root LICENSE but the architecture
overview's top-level tree (which enumerates root files like CLAUDE.md
and README.md) did not list it. Add it, noting it is repo-root only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Keeps per-user Claude Code local settings (.claude/settings.local.json),
env/secret files, and OS/editor junk out of the public repo. Nothing
sensitive is tracked today; this is preventive ahead of accepting
outside contributors.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…image

- Replace "Two big ideas" with the three founding objectives
  (automate-except-decisions, bake-in best practices, improve-the-workflow).
- Replace "The lifecycle" with "How it works": the new portrait
  task-cycle image plus a 10-step walk through one turn of the cycle,
  correcting the flow (commits are local; the branch is first pushed at
  PR creation; <project>-worktree / -worktree-done helper names).
- Quick start as prose; drop the manual bootstrap recipe (pointer kept).
- Remove "What's in this repo".
- Add a small "Questions?" section: ask Claude Code in a local clone.
- Soften Contributing (issues-only, PR proposals welcome as issues first).
- Trim Status.
- Refresh doc/assets/task-cycle.png to the new portrait diagram.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Use non-breaking hyphens (U+2011) inside the command code-spans in the
two reference tables so GitHub no longer wraps e.g. /cdd-merge-base into
"/cdd-merge-" + "base". Visually identical to a normal hyphen; the
copyable normal-hyphen forms remain in the prose above.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@drabaioli drabaioli merged commit 68eab20 into main Jun 23, 2026
1 check passed
@drabaioli drabaioli deleted the opensource_readme_license branch June 23, 2026 12:28
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