Skip to content

Commit b491026

Browse files
committed
Tighten CtrlC to React section packs; drop third-party test brands.
Public story is section packs plus recreation guidance, not full website creation or HTML scraping. Replace Tosea fixture strings with Northline or example.com. Keep monorepo demos Northline-only.
1 parent d4369fb commit b491026

17 files changed

Lines changed: 93 additions & 90 deletions

File tree

.claude/skills/ctrlc-clone/SKILL.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,11 +13,12 @@ Turn **$ARGUMENTS** into **reusable React sections** with **SectionPack** dual e
1313

1414
| Lead with | Do not promise |
1515
|-----------|----------------|
16-
| Clean **section / component** isolation | “Creates the full website” as the goal |
17-
| **Recreation guidance** (specs + describe + prompt packs) | Pixel-perfect full-site mirror |
18-
| **React** multi-file packs | HTML/CSS dump as the product |
16+
| **React section packs** (dual export) | Full website creation |
17+
| **Recreation guidance** (specs + describe + prompt packs) | Pixel-perfect full-page mirror |
18+
| Multi-file **React** packs | HTML scraping / CSS dump as the product |
1919
| Local-first rebuild you control | Bypassing auth / ToS |
2020

21+
Monorepo demos are **Northline** only. Do not commit third-party product rebuilds into the CtrlC repo.
2122
**Rights:** Only run on public pages the user may analyze (own site, permission, or lawful research). See monorepo `docs/guide/responsible-use.md`.
2223

2324
## Product rules

CHANGELOG.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,10 @@ Versions follow [SemVer](https://semver.org/) once 1.0.0 is cut. Pre-1.0 APIs ma
99

1010
### Changed - Positioning
1111

12-
- Lead with **reusable UI sections + recreation guidance + dual export**, not full-site cloning
12+
- Lead with **React section packs + recreation guidance** (not full website creation or HTML scraping)
1313
- Document **fidelity ladder** (structure → content → visual pass)
1414
- Strengthen **responsible use** (rights, ToS, no HTML dumps as product)
15-
- README, principles, clone skill, AGENTS template, docs hub aligned
15+
- Remove third-party product names from fixtures/comments; demos remain **Northline** only
1616

1717
## [0.1.0] - 2026-07-31
1818

@@ -46,6 +46,5 @@ Versions follow [SemVer](https://semver.org/) once 1.0.0 is cut. Pre-1.0 APIs ma
4646

4747
### Notes
4848

49-
- MVP suitable for local clone + SectionPack demos
50-
- npm publish deferred until API is marked stable (G2)
51-
- Live URL capture requires optional Playwright install
49+
- MVP: React section packs + dual export for local use
50+
- Not full website creation; not HTML scraping as the product

CONTRIBUTING.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributing
22

3-
**Positioning:** CtrlC extracts **reusable UI sections** and **recreation guidance** (SectionPack dual export) - not a full-site HTML cloner. Prefer that framing in docs, issues, and PRs. See [docs/guide/principles.md](docs/guide/principles.md) and [docs/guide/responsible-use.md](docs/guide/responsible-use.md).
3+
**Positioning:** **React section packs + recreation guidance** (SectionPack dual export). Not full website creation or HTML scraping. Prefer that framing in docs, issues, and PRs. Do not add third-party product clones (e.g. commercial site rebuilds) to this monorepo - demos stay **Northline** only. See [docs/guide/principles.md](docs/guide/principles.md) and [docs/guide/responsible-use.md](docs/guide/responsible-use.md).
44

55
## Docs
66

README.md

Lines changed: 32 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -5,49 +5,49 @@
55
[![Tests](https://img.shields.io/badge/tests-core%20%7C%20cli%20%7C%20capture%20%7C%20mcp-success)](package.json)
66
[![Status](https://img.shields.io/badge/status-0.1.x%20MVP-informational)](CHANGELOG.md)
77

8-
**CtrlC** (like Ctrl+C: **copy components**) turns a **public page you have rights to analyze** into **reusable UI sections** and **recreation guidance** - not a full-site mirror and not an HTML dump.
8+
**CtrlC** delivers **React section packs** and **recreation guidance** from a public page you may analyze.
99

10-
**SectionPack** is the dual-export layer on every section:
10+
**SectionPack** dual export on every section:
1111

12-
1. **Natural language** - what it does, motion, behavior, layout, color, multi-file influences
12+
1. **Natural language** - function, motion, behavior, layout, color, multi-file influences
1313
2. **Code as-is** - multi-file pack (TSX + content + CSS + deps)
1414

15-
> **Lead with sections, not “clone the whole website.”**
16-
> Extract clean, reusable blocks (hero, pricing, nav, FAQ, …) and guidance to rebuild them in React. Full-page composition is optional assembly - pixel-perfect full-site cloning is **not** the product promise.
15+
> Not full website creation. Not HTML scraping.
16+
> **React section packs + recreation guidance** - local-first, rights-aware.
1717
18-
## Why this is useful
19-
20-
Developers and designers already reverse-engineer UI by hand. CtrlC automates the hard parts:
18+
## Why
2119

2220
| Need | CtrlC |
2321
|------|--------|
2422
| Isolate reusable UI | Section IR + specs + React section components |
25-
| Hand-off to humans or agents | **Dual export**: brief + multi-file code pack |
26-
| Local control / privacy | CLI-first; work stays on your machine |
27-
| Avoid HTML scrapers | **React reconstruction** only - never ship mirrored HTML as the app |
28-
| Redesign / migrate | Structure + content + tokens as a starting point |
23+
| Hand-off to humans or agents | **Section packs**: brief + multi-file code |
24+
| Recreation guidance | Specs, behavior briefs, `describe` / `prompt` |
25+
| Local control | CLI-first; work stays on your machine |
26+
| Avoid scrapers | **React reconstruction only** - never ship mirrored HTML |
2927

3028
## What CtrlC is not
3129

3230
| Not this | Instead |
3331
|----------|---------|
34-
| Generic full-site cloner | **Section / component extraction** + assembly |
35-
| Pixel-perfect mirror guarantee | Structure → content → optional visual fidelity pass |
36-
| HTML/CSS dump product | **React** sections + SectionPack |
37-
| Bypass auth / ToS scraper | Public pages you may analyze; see [responsible use](docs/guide/responsible-use.md) |
32+
| Full website creation product | **React section packs** you compose |
33+
| HTML / CSS scrape or mirror host | Multi-file **React** packs + content modules |
34+
| Pixel-perfect full-page guarantee | Structure → content → optional visual pass |
35+
| Auth / ToS bypass tool | Public pages you have rights to analyze |
3836

3937
## Feature map
4038

4139
| Area | What you get |
4240
|------|----------------|
43-
| **Sections** | Capture IR, hygiene, specs, `scaffold-from-ir`, register |
44-
| **Guidance** | Specs, behavior briefs, builder prompts, `describe` / `prompt` packs |
45-
| **SectionPack** | Dual export, recipes, catalog, graph, library, drift |
41+
| **Section packs** | Capture IR, hygiene, specs, scaffold, register, dual export |
42+
| **Recreation guidance** | Specs, briefs, builder prompts, `describe` / `prompt` |
43+
| **SectionPack tooling** | Recipes, catalog, graph, library, drift |
4644
| **Pipeline** | `init-clone`, `pipeline`, tokens (`--ts-*`), assets, baseline |
4745
| **Quality** | `qa` (`--skip-build` when dev runs), `doctor`, optional visual-diff |
4846
| **Agents** | Skills + MCP (`@ctrlc/mcp`) |
4947
| **Ship** | Docker demo, CI, MIT |
5048

49+
Public demos use the fictional **Northline** brand only. No third-party product clones ship in this repo.
50+
5151
## Documentation
5252

5353
**Hub:** [docs/README.md](docs/README.md)
@@ -57,7 +57,7 @@ Developers and designers already reverse-engineer UI by hand. CtrlC automates th
5757
| Getting started | [docs/guide/getting-started.md](docs/guide/getting-started.md) |
5858
| Principles | [docs/guide/principles.md](docs/guide/principles.md) |
5959
| **Responsible use** | [docs/guide/responsible-use.md](docs/guide/responsible-use.md) |
60-
| Hybrid pipeline | [docs/workflows/hybrid-clone-pipeline.md](docs/workflows/hybrid-clone-pipeline.md) |
60+
| Section pipeline | [docs/workflows/hybrid-clone-pipeline.md](docs/workflows/hybrid-clone-pipeline.md) |
6161
| CLI reference | [docs/reference/cli.md](docs/reference/cli.md) |
6262
| Contributing | [CONTRIBUTING.md](CONTRIBUTING.md) |
6363
| Changelog | [CHANGELOG.md](CHANGELOG.md) |
@@ -117,9 +117,9 @@ npm run docker:demo
117117
# http://localhost:3040
118118
```
119119

120-
## Extract sections from a public page (one page)
120+
## Build React section packs from a public page
121121

122-
Use only on URLs you have **rights to analyze** (your site, licensed work, or permitted research). See [responsible use](docs/guide/responsible-use.md).
122+
Use only on URLs you have **rights to analyze**. See [responsible use](docs/guide/responsible-use.md).
123123

124124
```bash
125125
npm run build
@@ -130,7 +130,7 @@ cd ../my-sections && npm install
130130
ctrlc pipeline --url https://example.com --cwd . --out runs/example.com
131131

132132
ctrlc plan-parallel --cwd . --format md
133-
# Build React sections from docs/research/components/*.spec.md
133+
# Implement React sections from docs/research/components/*.spec.md
134134
ctrlc register-from-spec --cwd . --spec docs/research/components/hero.spec.md
135135
ctrlc pack hero --format describe --cwd .
136136
ctrlc pack hero --format prompt-short --cwd .
@@ -161,32 +161,32 @@ npm run snapshot && npm run check:drift
161161

162162
| Rule | Detail |
163163
|------|--------|
164-
| **Sections first** | Reusable blocks + packs; not “full website clone” as the pitch |
165-
| **Page default** | One URL → sections; full site only when requested |
164+
| **React section packs** | Dual export hand-off; compose a page from packs |
165+
| **Recreation guidance** | Specs + briefs + describe/prompt - not scrapes |
166+
| **Page default** | One URL → sections; multi-page only when requested |
166167
| **React only** | Never HTML product dumps |
167-
| **Dual export** | NL brief + multi-file code pack on every section |
168168
| **Config-first** | Every section registered for packs |
169169
| **Responsible use** | Rights, ToS, no phishing / brand theft |
170170

171171
## Status
172172

173-
**0.1.x MVP** - section extraction + SectionPack dual export path is implemented and tested. APIs may evolve before 1.0.
173+
**0.1.x MVP** - section packs + dual export path is implemented and tested. APIs may evolve before 1.0.
174174

175175
| Ready | Notes |
176176
|-------|--------|
177-
| Local section pipeline + dual export | Yes |
178-
| Demo + Docker + CI | Yes |
177+
| Local section packs + dual export | Yes |
178+
| Demo + Docker + CI | Yes (Northline only) |
179179
| MCP for agents | Yes (MVP) |
180180
| npm publish | Metadata ready; not published yet |
181181
| Live URL capture | Optional Playwright peer |
182-
| Pixel-perfect full page | **Not** a product guarantee |
182+
| Full website creation | **Not** the product |
183183

184184
## Responsible use
185185

186186
- Analyze **public** pages you own or have permission to study.
187-
- Rebuild for migration, redesign, learning, or internal sandboxes - not impersonation or phishing.
187+
- Rebuild for migration, redesign, learning, or internal sandboxes - not impersonation.
188188
- Respect site terms; do not bypass auth or paywalls.
189-
- Output is a **starting point for original React reimplementation**, not a license to copy brand assets or trademarks.
189+
- Output is a **starting point for original React reimplementation**, not a license to copy brand assets.
190190

191191
Full policy: [docs/guide/responsible-use.md](docs/guide/responsible-use.md).
192192

docs/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# CtrlC documentation
22

3-
**CtrlC** extracts **reusable UI sections** from a public page (with rights) and rebuilds them as **React** components - with recreation guidance.
4-
Default scope is **one page’s sections**. Full site is optional assembly. Pixel-perfect full-site cloning is **not** the product promise.
3+
**CtrlC** builds **React section packs** and **recreation guidance** from a public page you may analyze.
4+
Not full website creation. Not HTML scraping. Default: one page’s sections; multi-page only when requested.
55

6-
**SectionPack** is the dual-export layer on every section:
6+
**SectionPack** dual export on every section:
77

88
1. **Natural language** - function, motion, behavior, layout, color, multi-file influences
99
2. **Code as-is** - multi-file component pack (TSX + content + CSS + deps)
1010

11-
Never ship mirrored HTML dumps as the product. Lead with **sections + packs**, not “clone the whole website.”
11+
Public demos use the fictional **Northline** brand only.
1212
## Start here
1313

1414
| Path | Audience |

docs/guide/getting-started.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@
44

55
| Piece | Role |
66
|-------|------|
7-
| **CtrlC** | Extract and rebuild **reusable React sections** from a page (not HTML mirrors, not a full-site cloner pitch) |
7+
| **CtrlC** | **React section packs + recreation guidance** (not full website creation, not HTML scraping) |
88
| **SectionPack** | Per-section dual export: **natural language** guidance + **code as-is** packs |
9-
| **Northline demo** | Fictional analytics brand on port **3040** (original assets only) |
9+
| **Northline demo** | Fictional analytics brand on port **3040** - only product demo brand in this repo |
1010

1111
Read [Responsible use](./responsible-use.md) before capturing third-party URLs.
1212

docs/guide/principles.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22

33
Non-negotiable product rules for CtrlC and SectionPack.
44

5-
## 0. Sections first (positioning)
5+
## 0. React section packs + recreation guidance
66

77
| Lead with | Avoid as the hero pitch |
88
|-----------|-------------------------|
9-
| Reusable UI **sections** and **components** | “Creates the full website |
10-
| **Recreation guidance** + dual export | Generic site cloner / scraper |
11-
| Local React rebuild you control | Pixel-perfect full-site guarantee |
9+
| **React section packs** (dual export) | Full website creation |
10+
| **Recreation guidance** (specs, briefs, describe/prompt) | HTML scraping / mirror hosts |
11+
| Local React rebuild you control | Pixel-perfect full-page guarantee |
1212

13-
Full-page assembly is a **composition** of registered sections. Capture is an aid - not a license or a fidelity SLA.
13+
A page is a **composition** of registered section packs. Capture is an aid - not a license or a fidelity SLA. Monorepo demos ship **Northline** only - no third-party product clones.
1414

1515
## 1. React components only
1616

docs/guide/responsible-use.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,15 @@ It is **not** a tool for bulk commercial site theft, phishing, or bypassing acce
88

99
| Lead with | Do not lead with |
1010
|-----------|------------------|
11-
| Reusable sections / components | “Clone any full website |
12-
| Recreation guidance + dual export | Pixel-perfect full-site mirror |
11+
| **React section packs** | Full website creation |
12+
| **Recreation guidance** + dual export | Pixel-perfect full-page mirror |
1313
| Local React reconstruction | HTML scrape / mirror host |
1414
| Pages you have rights to use | Anything behind login / ToS bans |
1515

1616
Capture and pipeline outputs are **starting points for original reimplementation** - structure, content samples, and design notes - not a grant of rights to third-party brands, logos, or copy.
1717

18+
**Repo demos:** only the fictional **Northline** brand ships in this monorepo. Third-party product rebuilds (if any) are local tests outside the product tree - never publish them as CtrlC itself.
19+
1820
## Allowed (examples)
1921

2022
- Migrating a site **you own** off WordPress / Webflow / etc. into React

docs/templates/AGENTS.clone.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,11 @@
66

77
## Positioning
88

9-
- **Extract reusable sections** + recreation guidance - not full website clone.”
9+
- **React section packs + recreation guidance** - not full website creation or HTML scraping.
1010
- **Dual export** (NL brief + multi-file React pack) is the product hand-off.
11-
- **Fidelity ladder:** structure → content → visual pass. Capture alone is not pixel-perfect.
12-
- Only analyze pages the owner has **rights** to use. See monorepo `docs/guide/responsible-use.md`.
11+
- **Fidelity ladder:** structure → content → visual pass. Capture alone is not pixel parity.
12+
- Only analyze pages the owner has **rights** to use. See monorepo `docs/guide/responsible-use.md`.
13+
- Do not ship third-party commercial brands as the product demo; monorepo uses **Northline** only.
1314

1415
## Non-negotiable
1516

docs/workflows/hybrid-clone-pipeline.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Hybrid section pipeline (Ditto-inspired + agent-inspired)
22

3-
CtrlC’s recommended end-to-end flow **extracts reusable sections** and rebuilds them in React with recreation guidance. It is **not** a “full website cloner” product promise.
3+
CtrlC’s recommended end-to-end flow builds **React section packs** with **recreation guidance**. It is **not** full website creation or HTML scraping.
44

55
Flow:
66

0 commit comments

Comments
 (0)