Skip to content

Commit 853e55a

Browse files
committed
Add Source Project Context plugin
1 parent 9caec80 commit 853e55a

6 files changed

Lines changed: 388 additions & 0 deletions

File tree

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Source Project Context
2+
3+
This design-system workspace was created from an existing OpenDesign project. Treat the copied project files as the primary source evidence for the generated design system.
4+
5+
## Source project
6+
7+
- Source project id: 423b4bd1-640e-4dcd-9cb1-e11aa0c9186d
8+
- Source project name: Web Prototype
9+
- New design-system project id: aeadc299-6651-467a-b576-7c242466acdf
10+
- New design-system id: user:web-prototype-design-system
11+
- Source skill id: (none)
12+
- Source design system id: (none)
13+
14+
## Source metadata
15+
16+
```json
17+
{
18+
"kind": "prototype",
19+
"nameSource": "prompt",
20+
"linkedDirs": [
21+
"/Users/parasana/Downloads/Antigravity/portifolio"
22+
]
23+
}
24+
```
25+
26+
## Copied files
27+
28+
- portfolio-os.html
29+
- sketch-2026-08-21T07-55-24.sketch.json
30+
- tsconfig.json
31+
- README.md
32+
- quality.md
33+
- skills-lock.json
34+
- package.json
35+
- postcss.config.mjs
36+
- package-lock.json
37+
- AGENTS.md
38+
- next.config.ts
39+
- k8s-deployment.yaml
40+
- next-env.d.ts
41+
- eslint.config.mjs
42+
- Dockerfile
43+
- docker-compose.yml
44+
- components.json
45+
- CLAUDE.md
46+
47+
## Skipped files
48+
49+
- (none)
50+
51+
## Generation contract
52+
53+
- Read this file before editing design-system outputs.
54+
- Read the copied files directly from the project workspace; they are source evidence, not generated design-system output.
55+
- Preserve high-signal assets, source examples, UI surfaces, copy, tokens, typography, and interaction patterns from the copied project.
56+
- Generate a reusable OpenDesign design-system package in this same project: DESIGN.md, README.md, SKILL.md, colors_and_type.css, context/provenance, focused preview cards, preserved assets/build/fonts when available, and ui_kits/app/.
57+
- Before final response, run `"$OD_NODE_BIN" "$OD_BIN" tools connectors design-system-package-audit --path . --fail-on-warnings` and fix every actionable issue.
58+
59+
## Provenance
60+
61+
Formalized by OpenDesign from candidate 7961d4b0-0f9c-4641-9a72-52f59fc57f17.
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
{
2+
"$schema": "https://open-design.ai/schemas/plugin.v1.json",
3+
"specVersion": "1.0.0",
4+
"name": "source-project-context-mt2rgq9e",
5+
"title": "Source Project Context",
6+
"version": "0.1.0",
7+
"description": "This design-system workspace was created from an existing OpenDesign project. Treat the copied project files as the primary source evidence for the generated design system.",
8+
"od": {
9+
"kind": "skill",
10+
"taskKind": "new-generation",
11+
"context": {
12+
"skills": [
13+
{
14+
"path": "./SKILL.md"
15+
}
16+
]
17+
},
18+
"capabilities": [
19+
"prompt:inject"
20+
]
21+
}
22+
}
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
{
2+
"candidateId": "7961d4b0-0f9c-4641-9a72-52f59fc57f17",
3+
"projectId": "aeadc299-6651-467a-b576-7c242466acdf",
4+
"runId": "f1e2c551-9885-4924-9a79-21a46d2065f5",
5+
"conversationId": "9885d553-50a0-40cf-864b-134b244fced2",
6+
"provenance": {
7+
"summary": "Detected from context/source-context.md, README.md, SKILL.md after a successful run.",
8+
"detectedAt": 1787305339764
9+
},
10+
"sourceRefs": [
11+
{
12+
"kind": "file",
13+
"value": "context/source-context.md",
14+
"label": "context/source-context.md",
15+
"size": 1774,
16+
"copied": true
17+
},
18+
{
19+
"kind": "file",
20+
"value": "README.md",
21+
"label": "README.md",
22+
"size": 5171,
23+
"copied": true
24+
},
25+
{
26+
"kind": "file",
27+
"value": "SKILL.md",
28+
"label": "SKILL.md",
29+
"size": 2864,
30+
"copied": true
31+
}
32+
]
33+
}
Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Source Project Context
2+
3+
This design-system workspace was created from an existing OpenDesign project. Treat the copied project files as the primary source evidence for the generated design system.
4+
5+
## Source project
6+
7+
- Source project id: 423b4bd1-640e-4dcd-9cb1-e11aa0c9186d
8+
- Source project name: Web Prototype
9+
- New design-system project id: aeadc299-6651-467a-b576-7c242466acdf
10+
- New design-system id: user:web-prototype-design-system
11+
- Source skill id: (none)
12+
- Source design system id: (none)
13+
14+
## Source metadata
15+
16+
```json
17+
{
18+
"kind": "prototype",
19+
"nameSource": "prompt",
20+
"linkedDirs": [
21+
"/Users/parasana/Downloads/Antigravity/portifolio"
22+
]
23+
}
24+
```
25+
26+
## Copied files
27+
28+
- portfolio-os.html
29+
- sketch-2026-08-21T07-55-24.sketch.json
30+
- tsconfig.json
31+
- README.md
32+
- quality.md
33+
- skills-lock.json
34+
- package.json
35+
- postcss.config.mjs
36+
- package-lock.json
37+
- AGENTS.md
38+
- next.config.ts
39+
- k8s-deployment.yaml
40+
- next-env.d.ts
41+
- eslint.config.mjs
42+
- Dockerfile
43+
- docker-compose.yml
44+
- components.json
45+
- CLAUDE.md
46+
47+
## Skipped files
48+
49+
- (none)
50+
51+
## Generation contract
52+
53+
- Read this file before editing design-system outputs.
54+
- Read the copied files directly from the project workspace; they are source evidence, not generated design-system output.
55+
- Preserve high-signal assets, source examples, UI surfaces, copy, tokens, typography, and interaction patterns from the copied project.
56+
- Generate a reusable OpenDesign design-system package in this same project: DESIGN.md, README.md, SKILL.md, colors_and_type.css, context/provenance, focused preview cards, preserved assets/build/fonts when available, and ui_kits/app/.
57+
- Before final response, run `"$OD_NODE_BIN" "$OD_BIN" tools connectors design-system-package-audit --path . --fail-on-warnings` and fix every actionable issue.
Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
# Project As Complete OpenDesign Design System
2+
3+
> A reusable, production-ready design system for technical portfolios and high-impact engineering showcases.
4+
5+
---
6+
7+
## Overview
8+
9+
This design system is derived from the **Portfolio OS** project, a personal technical showcase engineered for Big Tech visibility and freelance impact. It is not a generic portfolio template; it is a **digital twin** of engineering capabilities, designed to demonstrate production-grade precision, security, and futuristic aesthetics.
10+
11+
---
12+
13+
## Design System Package
14+
15+
### Core Files
16+
17+
| File | Purpose |
18+
|------|---------|
19+
| `DESIGN.md` | Complete design system specification with tokens, components, and rules |
20+
| `SKILL.md` | Skill definition for reuse in OpenDesign projects |
21+
| `colors_and_type.css` | CSS variables for colors, typography, spacing, and motion |
22+
| `context/provenance.md` | Evidence and source references for design decisions |
23+
24+
### Preview Cards
25+
26+
| Card | Purpose |
27+
|------|---------|
28+
| `preview/colors.html` | Visual review of the color palette and semantic roles |
29+
| `preview/typography.html` | Typography scale, typefaces, and rendering examples |
30+
| `preview/spacing.html` | Spacing scale, layout density, and container examples |
31+
| `preview/radius_shadows.html` | Border radius, shadows, and depth effects |
32+
| `preview/components.html` | Interactive component gallery (buttons, cards, forms, navigation) |
33+
| `preview/brand_assets.html` | Logo, wordmark, and brand identity examples |
34+
| `preview/applied_ui.html` | Applied interface surfaces (hero, about, projects, contact) |
35+
36+
### Applied Interface Kit
37+
38+
| Path | Purpose |
39+
|------|---------|
40+
| `ui_kits/app/` | Production-ready interface kit with index and component files |
41+
| `ui_kits/app/index.html` | Entry point for the applied UI kit |
42+
| `ui_kits/app/components/` | Reusable component examples |
43+
44+
### Assets
45+
46+
| Path | Purpose |
47+
|------|---------|
48+
| `assets/fonts/` | Font files (Space Grotesk, Inter, JetBrains Mono) |
49+
| `assets/icons/` | SVG icons and logos |
50+
| `assets/images/` | Background images, mesh textures, and brand imagery |
51+
52+
---
53+
54+
## Usage
55+
56+
### For Designers
57+
58+
1. **Review the design system:**
59+
- Start with `DESIGN.md` for tokens, components, and rules.
60+
- Use preview cards to inspect colors, typography, spacing, and components.
61+
- Reference `colors_and_type.css` for CSS variables.
62+
63+
2. **Apply the system:**
64+
- Use OKLch tokens for all colors.
65+
- Use Space Grotesk for display, Inter for body, JetBrains Mono for mono.
66+
- Follow component patterns for buttons, cards, forms, and navigation.
67+
68+
3. **Preserve authenticity:**
69+
- Do not deviate from the locked visual language.
70+
- Use realistic technical imagery and code examples.
71+
72+
### For Developers
73+
74+
1. **Integrate tokens:**
75+
```css
76+
:root {
77+
--bg: oklch(0 0 0);
78+
--surface: oklch(0.14 0.004 250);
79+
--fg: oklch(0.97 0.005 80);
80+
--muted: oklch(0.65 0.01 250);
81+
--border: oklch(0.26 0.006 250);
82+
--accent: oklch(0.82 0.16 80);
83+
}
84+
```
85+
86+
2. **Use components:**
87+
- Buttons: `.btn-primary`, `.btn-secondary`
88+
- Cards: `.card`
89+
- Navigation: `.topnav`
90+
- Forms: Plain inputs with `--surface` background
91+
92+
3. **Respect constraints:**
93+
- Only one primary button per viewport.
94+
- Use `--accent` sparingly (no more than twice per screen).
95+
- Ensure all interactive elements have clear focus rings.
96+
97+
---
98+
99+
## Provenance
100+
101+
### Source Evidence
102+
103+
- **portfolio-os.html:** Primary source for tokens, components, layout, and interaction patterns.
104+
- **README.md:** Provides context for purpose, tech stack, and future roadmap.
105+
- **quality.md:** Confirms TypeScript, linting, accessibility, and performance standards.
106+
- **components.json:** Confirms Tailwind CSS 4, OKLCH color space, and shadcn/ui usage.
107+
- **package.json:** Confirms bleeding-edge stack (Next.js 16, React 19, Framer Motion, Tailwind CSS 4).
108+
109+
### Preserved Assets
110+
111+
- **Fonts:** Space Grotesk, Inter, JetBrains Mono (loaded from Google Fonts).
112+
- **Icons:** SVG icons used in feature marks and buttons.
113+
- **Imagery:** Mesh background, vignette overlay, and status dot animations.
114+
115+
---
116+
117+
## Next Steps
118+
119+
1. **Inspect previews:** Start with `preview/colors.html` and `preview/components.html`.
120+
2. **Apply to projects:** Use the system for new technical portfolios or engineering showcases.
121+
3. **Contribute:** Extend the system with new components or refinements based on real-world usage.
122+
123+
---
124+
125+
## Summary
126+
127+
This design system is a **production-ready, high-impact** system for technical portfolios. It balances geometric typography, vibrant amber accents, and dynamic motion to convey precision engineering and futuristic ambition. Every decision is rooted in the source project's evidence, ensuring consistency and authenticity.
128+
129+
**Key takeaways:**
130+
- Use OKLch tokens for all colors.
131+
- Use Space Grotesk for display, Inter for body, JetBrains Mono for mono.
132+
- Use `--accent` sparingly—no more than twice per screen.
133+
- Motion should enhance clarity, not distract.
134+
- Avoid generic templates; prioritize realism and technical authenticity.
135+
136+
---
137+
138+
**Design system id:** user:web-prototype-design-system
139+
**Project id:** aeadc299-6651-467a-b576-7c242466acdf
Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
# Project As Complete OpenDesign Design System Skill
2+
3+
> A specialized skill for creating technical portfolios and high-impact engineering showcases.
4+
5+
---
6+
7+
## Instructions
8+
9+
This skill governs the creation and refinement of projects using the **Project As Complete OpenDesign Design System**. It enforces the system's visual language, component patterns, and technical standards.
10+
11+
### 1. Bind Design System Tokens
12+
13+
Every project created with this skill must bind the following OKLch tokens to its `:root` block:
14+
15+
```css
16+
:root {
17+
--bg: oklch(0 0 0);
18+
--surface: oklch(0.14 0.004 250);
19+
--fg: oklch(0.97 0.005 80);
20+
--muted: oklch(0.65 0.01 250);
21+
--border: oklch(0.26 0.006 250);
22+
--accent: oklch(0.82 0.16 80);
23+
--accent-soft: oklch(0.82 0.16 80 / 0.14);
24+
--fg-soft: oklch(0.97 0.005 80 / 0.06);
25+
26+
--font-display: 'Space Grotesk', sans-serif;
27+
--font-body: 'Inter', -apple-system, system-ui, sans-serif;
28+
--font-mono: 'JetBrains Mono', ui-monospace, monospace;
29+
}
30+
```
31+
32+
### 2. Follow Component Patterns
33+
34+
| Component | Rule |
35+
|-----------|------|
36+
| **Buttons** | Only one primary button (`.btn-primary`) per viewport. |
37+
| **Cards** | Use `.card` with hover feedback (border color shift to `--accent`). |
38+
| **Navigation**| Fixed top navigation bar (`.topnav`) with backdrop blur. |
39+
| **Forms** | Use `--surface` background for inputs/textareas. |
40+
41+
### 3. Enforce Visual Constraints
42+
43+
- **Accent color:** Use `--accent` sparingly—no more than twice per screen.
44+
- **Typography:** Space Grotesk for headings, Inter for body, JetBrains Mono for mono.
45+
- **Motion:** Subtle, fast for interactions; slow, ambient for background effects.
46+
- **Contrast:** Ensure all text and icons have sufficient contrast in all states.
47+
- **Accessibility:** Use semantic HTML and provide clear focus rings.
48+
49+
### 4. Technical Standards
50+
51+
- **Color space:** Use OKLch for all color values.
52+
- **Framework:** Next.js 16 (App Router) + React 19 + Tailwind CSS 4.
53+
- **Realism:** Use realistic technical imagery and code examples.
54+
- **Security:** Follow security best practices for data handling and bot protection.
55+
56+
---
57+
58+
## Commands
59+
60+
| Command | Purpose |
61+
|---------|---------|
62+
| `/plan` | Generate a task plan for creating or refining a project. |
63+
| `/build`| Build project artifacts based on the design system. |
64+
| `/verify`| Verify project artifacts against design system rules. |
65+
| `/ship` | Finalize and ship project artifacts. |
66+
67+
---
68+
69+
## Summary
70+
71+
This skill is designed to help you create technical portfolios and high-impact engineering showcases that demonstrate production-grade precision and futuristic aesthetics. By following the design system's tokens, component patterns, and visual constraints, you can ensure consistency and authenticity across all projects.
72+
73+
---
74+
75+
**Design system id:** user:web-prototype-design-system
76+
**Project id:** aeadc299-6651-467a-b576-7c242466acdf

0 commit comments

Comments
 (0)