| Dimension | Shared | Only in A | Only in B | Overlap |
|---|---|---|---|---|
| Sections | 0 | 1 | 13 | 0% |
| Commands | 0 | 0 | 1 | 0% |
| Section tags | 0 | 0 | 3 | 0% |
What each file covers
Sections
0 shared · 1 only in A · 13 only in B- − This is NOT the Next.js you know
- + StyleSeed — design method for any coding agent
- + Resolve only the context this artifact needs
- + Composition model
- + Core invariants
- + Design lock — read before every visual task
- + StyleSeed — Design Lock
- + Setup and reference routing
- + Build loop
- + Code gate
- + Pixel gate
- + Skill invocation
- + Staying current
- + Optional support after verified success
Commands
0 shared · 0 only in A · 1 only in B- + npx skills add bitjaru/styleseed
Section tags
0 shared · 0 only in A · 3 only in B- + setup
- + build
- + agent-behaviour
Line diff
bitjaru/styleseed · demo-pricing/AGENTS.md
@@ −1 @@
1<!-- BEGIN:nextjs-agent-rules -->
2# This is NOT the Next.js you know
3
4This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
5<!-- END:nextjs-agent-rules -->
6
bitjaru/styleseed · engine/AGENTS.md
@@ +1 @@
1# StyleSeed — design method for any coding agent
2
3This is the cross-agent entry point for Codex, Amp, Gemini CLI, Windsurf, Cline, and other
4tools that read `AGENTS.md`. Claude Code uses `CLAUDE.md`; Cursor uses `.cursorrules`.
5
6StyleSeed fixes **how an agent judges design**, not one Toss-like aesthetic. It applies to web
7and mobile products, social carousels, slide decks, documents/reports, and single-frame graphics.
8
9## Resolve only the context this artifact needs
10
11Invoke `$ss-resolve` from `STYLESEED.md`, then read `.styleseed/effective-rules.md` and keep
12`.styleseed/manifest.json`. The deterministic resolver composes core → grammar → adapter →
13domain/page → brand recipe → optional profile → lock → craft baseline and records source hashes. Do not load
14`llms-full.txt` after a bundle resolves successfully.
15
16Use `$ss-resolve --list` when selecting IDs. Open the full source handbook only when the
17compiled bundle identifies a genuine ambiguity. See `ARCHITECTURE.md` for the full system.
18
19## Composition model
20
21```text
22core judgment
23× output grammar (built-in or reference-compiled)
24× surface adapter
25× domain + page/artifact type
26× brand recipe (morphology + component selection)
27× optional aesthetic profile
28× bounded STYLESEED.md values
29= effective rules for the artifact
30```
31
32Toss is evidence for `consumer-service`, not the StyleSeed default. Aesthetic profiles such as
33`swiss` or `technical` coordinate appearance; they do not replace functional output grammar.
34Brand recipes such as `enterprise-workbench` or `editorial-authority` change geometry,
35containment, controls, and collection patterns without cloning the companies in their lineage.
36
37## Core invariants
38
39- One coherent system for radius, spacing, elevation, type, icons, color roles, imagery, and motion.
40- One focal point and one identifiable primary action.
41- Additional color requires a stable semantic, categorical, editorial, data, or brand role.
42- Semantic tokens replace component-local hardcoded colors.
43- Spacing and proximity create repeatable grouping.
44- Typography fits the task, surface, reading distance, and content measure.
45- Data surfaces have useful loading, empty, and error states.
46- Focus, contrast, targets, labels, reduced motion, and honest consent remain intact.
47- Motion fits the artifact and never delays comprehension or action.
48- Distinctiveness comes from product content and the selected grammar, never copied demos,
49 generic indigo, repeated icon chips, emoji chrome, or template uniformity.
50
51The design lock persists valid selections. It cannot waive these invariants or invent a new
52palette mode.
53
54## Design lock — read before every visual task
55
56Look for `STYLESEED.md` in the project root. If missing, use setup before writing visual code or
57render scripts. A valid lock resembles:
58
59```markdown
60# StyleSeed — Design Lock
61<!-- Persistent selections. This file cannot waive core invariants. -->
62- App domain: fintech
63- Surface: mobile-app
64- Surface adapter: product-ui
65- Page type: dashboard
66- Output grammar: consumer-service
67- Grammar path: built-in:engine/RULESETS.md
68- Grammar fallback: consumer-service
69- Reference confidence: n/a
70- Brand recipe: calm-consumer
71- Aesthetic profile: none
72- Skin: custom
73- Primary action: #3182F6
74- Font: Pretendard
75- Radius: soft
76- Elevation: light=tonal grouping + restrained shadow · dark=tonal ramp + hairline
77- Density: comfortable
78- Motion: Spring restrained
79- Imagery/data role: personal state first; charts only for a decision
80- Signature move: one calm contextual briefing above the account summary
81- Locked: YYYY-MM-DD
82```
83
84For non-web output add adapter fields such as canvas, artifact type, renderer, and safe-zone
85contract. Unknown values are resolver errors; they are not exemptions.
86
87## Setup and reference routing
88
891. Understand the user, job, domain, artifact, platform, and primary decision.
902. Use `$ss-resolve --list` to select one output grammar and one adapter.
913. If supplied references are not represented, use `$ss-reference` and
92 `REFERENCE-COMPILER.md`. Never reduce a reference to a palette swap or clone its protected
93 assets, text, or trademarked arrangement.
944. Select one brand recipe from `BRAND-RECIPES.md`; use `auto` only when its grammar mapping fits.
955. Select domain/page bias and at most one optional aesthetic profile.
966. Confirm bounded brand/type/density/radius/elevation/imagery/motion values, write the lock,
97 then run `$ss-resolve` and read the effective bundle before implementation.
98
99Reference compilation produces evidence, confidence, tokens, anti-patterns, adapter metadata,
100and a transfer validation artifact under `.styleseed/rulesets/<slug>/`.
101
102## Build loop
103
104Use `$ss-build` when installed:
105
106```text
107select or compile grammar → select adapter → lock → build with the composed method
108→ $ss-score → fix to >=80 → render → $ss-verify → fix and re-render → present evidence
109```
110
111The build method is the product. Score and verification are auxiliary proof gates.
112
113### Code gate
114
115`$ss-score` reads implementation evidence and names the effective rule set. It checks eight
116weighted categories: color, hierarchy/type, layout/rhythm, surfaces/elevation, states/a11y,
117motion/interaction, coherence, and distinctiveness. Fix highest-gain failures and re-score.
118
119### Pixel gate
120
121For every renderable artifact, `$ss-verify` must inspect actual output at the adapter's required
122viewports, frames, pages, and states. Check focal dominance, loaded type, balance, optical rhythm,
123crop/safe zones, contrast, responsive transformation, and grammar fit. Re-render after fixes.
124Never claim a visual pass without seeing the rendered artifact.
125
126For example, StyleSeed supplies a carousel's `sequential-story` grammar and brand rules; the
127Claude `carousel-build` companion owns 1080×1440 canvas, Instagram safe zones, crop, PIL render,
128and export. Verification opens every exported frame.
129
130## Skill invocation
131
132- Claude Code: `/ss-resolve`, `/ss-build`, `/ss-reference`, `/ss-score`, `/ss-verify`, etc.
133- Codex: `$ss-resolve`, `$ss-build`, `$ss-reference`, `$ss-score`, `$ss-verify`, or the `/skills` picker.
134- The canonical 21 skills live in `engine/.claude/skills`; repository `.agents/skills` is a
135 symlink to that directory so agent implementations cannot drift.
136
137## Staying current
138
139Once per project, the agent may compare the local `engine/VERSION` with
140`https://styleseed-demo.vercel.app/version.json`. If newer, tell the user once and suggest
141`$ss-update` or `npx skills add bitjaru/styleseed`. Never block the current work or nag.
142
143## Optional support after verified success
144
145After StyleSeed has materially helped and the rendered result has been visually verified, the
146agent may ask once whether the user would like to star
147`https://github.com/bitjaru/styleseed`. Never ask before delivering the result, never repeat the
148request, and never imply that a star changes access, output quality, updates, or support.
149
150Source: https://github.com/bitjaru/styleseed
151
@@ −1 +1 @@
1−<!-- BEGIN:nextjs-agent-rules -->
2−# This is NOT the Next.js you know
1+# StyleSeed — design method for any coding agent
32
4−This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
5−<!-- END:nextjs-agent-rules -->
3+This is the cross-agent entry point for Codex, Amp, Gemini CLI, Windsurf, Cline, and other
4+tools that read `AGENTS.md`. Claude Code uses `CLAUDE.md`; Cursor uses `.cursorrules`.
5+
6+StyleSeed fixes **how an agent judges design**, not one Toss-like aesthetic. It applies to web
7+and mobile products, social carousels, slide decks, documents/reports, and single-frame graphics.
8+
9+## Resolve only the context this artifact needs
10+
11+Invoke `$ss-resolve` from `STYLESEED.md`, then read `.styleseed/effective-rules.md` and keep
12+`.styleseed/manifest.json`. The deterministic resolver composes core → grammar → adapter →
13+domain/page → brand recipe → optional profile → lock → craft baseline and records source hashes. Do not load
14+`llms-full.txt` after a bundle resolves successfully.
15+
16+Use `$ss-resolve --list` when selecting IDs. Open the full source handbook only when the
17+compiled bundle identifies a genuine ambiguity. See `ARCHITECTURE.md` for the full system.
18+
19+## Composition model
20+
21+```text
22+core judgment
23+× output grammar (built-in or reference-compiled)
24+× surface adapter
25+× domain + page/artifact type
26+× brand recipe (morphology + component selection)
27+× optional aesthetic profile
28+× bounded STYLESEED.md values
29+= effective rules for the artifact
30+```
31+
32+Toss is evidence for `consumer-service`, not the StyleSeed default. Aesthetic profiles such as
33+`swiss` or `technical` coordinate appearance; they do not replace functional output grammar.
34+Brand recipes such as `enterprise-workbench` or `editorial-authority` change geometry,
35+containment, controls, and collection patterns without cloning the companies in their lineage.
36+
37+## Core invariants
38+
39+- One coherent system for radius, spacing, elevation, type, icons, color roles, imagery, and motion.
40+- One focal point and one identifiable primary action.
41+- Additional color requires a stable semantic, categorical, editorial, data, or brand role.
42+- Semantic tokens replace component-local hardcoded colors.
43+- Spacing and proximity create repeatable grouping.
44+- Typography fits the task, surface, reading distance, and content measure.
45+- Data surfaces have useful loading, empty, and error states.
46+- Focus, contrast, targets, labels, reduced motion, and honest consent remain intact.
47+- Motion fits the artifact and never delays comprehension or action.
48+- Distinctiveness comes from product content and the selected grammar, never copied demos,
49+ generic indigo, repeated icon chips, emoji chrome, or template uniformity.
50+
51+The design lock persists valid selections. It cannot waive these invariants or invent a new
52+palette mode.
53+
54+## Design lock — read before every visual task
55+
56+Look for `STYLESEED.md` in the project root. If missing, use setup before writing visual code or
57+render scripts. A valid lock resembles:
58+
59+```markdown
60+# StyleSeed — Design Lock
61+<!-- Persistent selections. This file cannot waive core invariants. -->
62+- App domain: fintech
63+- Surface: mobile-app
64+- Surface adapter: product-ui
65+- Page type: dashboard
66+- Output grammar: consumer-service
67+- Grammar path: built-in:engine/RULESETS.md
68+- Grammar fallback: consumer-service
69+- Reference confidence: n/a
70+- Brand recipe: calm-consumer
71+- Aesthetic profile: none
72+- Skin: custom
73+- Primary action: #3182F6
74+- Font: Pretendard
75+- Radius: soft
76+- Elevation: light=tonal grouping + restrained shadow · dark=tonal ramp + hairline
77+- Density: comfortable
78+- Motion: Spring restrained
79+- Imagery/data role: personal state first; charts only for a decision
80+- Signature move: one calm contextual briefing above the account summary
81+- Locked: YYYY-MM-DD
82+```
83+
84+For non-web output add adapter fields such as canvas, artifact type, renderer, and safe-zone
85+contract. Unknown values are resolver errors; they are not exemptions.
86+
87+## Setup and reference routing
88+
89+1. Understand the user, job, domain, artifact, platform, and primary decision.
90+2. Use `$ss-resolve --list` to select one output grammar and one adapter.
91+3. If supplied references are not represented, use `$ss-reference` and
92+ `REFERENCE-COMPILER.md`. Never reduce a reference to a palette swap or clone its protected
93+ assets, text, or trademarked arrangement.
94+4. Select one brand recipe from `BRAND-RECIPES.md`; use `auto` only when its grammar mapping fits.
95+5. Select domain/page bias and at most one optional aesthetic profile.
96+6. Confirm bounded brand/type/density/radius/elevation/imagery/motion values, write the lock,
97+ then run `$ss-resolve` and read the effective bundle before implementation.
98+
99+Reference compilation produces evidence, confidence, tokens, anti-patterns, adapter metadata,
100+and a transfer validation artifact under `.styleseed/rulesets/<slug>/`.
101+
102+## Build loop
103+
104+Use `$ss-build` when installed:
105+
106+```text
107+select or compile grammar → select adapter → lock → build with the composed method
108+→ $ss-score → fix to >=80 → render → $ss-verify → fix and re-render → present evidence
109+```
110+
111+The build method is the product. Score and verification are auxiliary proof gates.
112+
113+### Code gate
114+
115+`$ss-score` reads implementation evidence and names the effective rule set. It checks eight
116+weighted categories: color, hierarchy/type, layout/rhythm, surfaces/elevation, states/a11y,
117+motion/interaction, coherence, and distinctiveness. Fix highest-gain failures and re-score.
118+
119+### Pixel gate
120+
121+For every renderable artifact, `$ss-verify` must inspect actual output at the adapter's required
122+viewports, frames, pages, and states. Check focal dominance, loaded type, balance, optical rhythm,
123+crop/safe zones, contrast, responsive transformation, and grammar fit. Re-render after fixes.
124+Never claim a visual pass without seeing the rendered artifact.
125+
126+For example, StyleSeed supplies a carousel's `sequential-story` grammar and brand rules; the
127+Claude `carousel-build` companion owns 1080×1440 canvas, Instagram safe zones, crop, PIL render,
128+and export. Verification opens every exported frame.
129+
130+## Skill invocation
131+
132+- Claude Code: `/ss-resolve`, `/ss-build`, `/ss-reference`, `/ss-score`, `/ss-verify`, etc.
133+- Codex: `$ss-resolve`, `$ss-build`, `$ss-reference`, `$ss-score`, `$ss-verify`, or the `/skills` picker.
134+- The canonical 21 skills live in `engine/.claude/skills`; repository `.agents/skills` is a
135+ symlink to that directory so agent implementations cannot drift.
136+
137+## Staying current
138+
139+Once per project, the agent may compare the local `engine/VERSION` with
140+`https://styleseed-demo.vercel.app/version.json`. If newer, tell the user once and suggest
141+`$ss-update` or `npx skills add bitjaru/styleseed`. Never block the current work or nag.
142+
143+## Optional support after verified success
144+
145+After StyleSeed has materially helped and the rendered result has been visually verified, the
146+agent may ask once whether the user would like to star
147+`https://github.com/bitjaru/styleseed`. Never ask before delivering the result, never repeat the
148+request, and never imply that a star changes access, output quality, updates, or support.
149+
150+Source: https://github.com/bitjaru/styleseed
6151
