Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"displayName": "Artic"
},
"description": "Reference-driven AI-native design docs for homepage generation.",
"version": "0.4.1",
"version": "0.5.0",
"author": "baskduf",
"plugins": [
{
Expand Down
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "artic",
"display_name": "Artic",
"description": "Reference-driven AI-native design docs for homepage generation.",
"version": "0.4.1",
"version": "0.5.0",
"author": "baskduf",
"plugins": [
{
Expand Down
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
# Changelog

## 0.5.0 - 2026-06-20

### Removed
- Removed the public `@artic show` and `@artic review` workflow surface to keep Artic focused on `@artic init` → `@artic start`.
- Removed show preview bundle generation, risk-readiness gating, production-readiness status fields, and related defensive output sections from the skill, scripts, schemas, validators, docs, and mirrored Claude/Codex packages.

### Changed
- Reframed reference safety as constructive design-principle extraction for original project-specific direction.

## 0.4.1 - 2026-06-20

### Fixed
Expand Down
68 changes: 0 additions & 68 deletions HANDOFF.md

This file was deleted.

23 changes: 3 additions & 20 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,11 +21,9 @@ Artic は、実装前にホームページのデザイン方向を契約とし
```text
@artic init # 意図と参照を収集
@artic start # strategy artifacts を作成し DESIGN.md 文書をコンパイル
@artic show # provenance を記録した asset-first preview bundle をレンダリング
@artic review # 実装を文書に照らして確認
```

エージェントは内部で、ユーザーへのヒアリング、brief の検索 facet 化、専門/OSS デザイン参照の検索、`.artic/strategy.json` 作成、`DESIGN.md` と補助文書のコンパイル、出力検証を処理します。スクリプトは validator/compiler/renderer helper であり、design judgment や strategy authorship を置き換えません。
エージェントは内部で、ユーザーへのヒアリング、brief の検索 facet 化、専門/OSS デザイン参照の検索、`.artic/strategy.json` 作成、`DESIGN.md` と補助文書のコンパイル、出力検証を処理します。スクリプトは validator/compiler helper であり、design judgment や strategy authorship を置き換えません。

> Artic は参照サイトを **クローンしません**。専門/OSS デザインシステムから再利用可能な原則を抽出し、project-specific な strategy と AI-native docs に実装を結び付けます。

Expand All @@ -45,7 +43,6 @@ marketplace パッケージをインストールします:
```text
/claude-artic:artic init
/claude-artic:artic start
/claude-artic:artic show
```

自然文でも依頼できます:
Expand All @@ -65,7 +62,7 @@ codex plugin marketplace add baskduf/artic
安定したインストールが必要な場合はリリースタグに固定します:

```bash
codex plugin marketplace add baskduf/artic@v0.4.1
codex plugin marketplace add baskduf/artic@v0.5.0
```

プラグインブラウザから `codex-artic` をインストールします:
Expand All @@ -85,7 +82,6 @@ Codex に依頼します:
```text
@artic init
@artic start
@artic show
```

### Local checkout fallback
Expand All @@ -104,12 +100,11 @@ python3 skills/artic/scripts/synthesize_reference_notes.py --query "ai product d
python3 skills/artic/scripts/synthesize_reference_notes.py --query "ai product developer saas" --limit 3 --live-fetch --cache-dir /tmp/artic-cache --fixtures-dir /tmp/no-fixtures --output /tmp/artic-smoke/docs/live-reference-synthesis.md
python3 skills/artic/scripts/scaffold_artic_files.py --root /tmp/artic-smoke
python3 skills/artic/scripts/validate_artic_outputs.py --root /tmp/artic-smoke
python3 skills/artic/scripts/artic_show.py --root .
python3 skills/artic/scripts/artic_version.py --root .
python3 skills/artic/scripts/artic_update.py --root .
```

Helper scripts は deterministic helper です。`validate_artic_outputs.py` は contract を検証し、`artic_start.py` は agent-authored strategy を文書へコンパイルし、`artic_show.py` は preview をレンダリングします。design judgment の出所はスクリプトではなく、public `@artic start` agent workflow が作成する `.artic/strategy.json` です。
Helper scripts は deterministic helper です。`validate_artic_outputs.py` は contract を検証し、`artic_start.py` は agent-authored strategy を文書へコンパイルします。design judgment の出所はスクリプトではなく、public `@artic start` agent workflow が作成する `.artic/strategy.json` です。

## What Changes In The Agent

Expand All @@ -121,8 +116,6 @@ Artic が呼び出されると、エージェントは次を行います:
4. 色の役割、タイプ階層、余白リズム、コンポーネント、モーション、アクセシビリティなど、再利用可能なルールを抽出します。
5. ユーザーのプロジェクト目標に基づいて、レファレンス間の衝突を解決します。
6. `@artic start` で public agent workflow が `.artic/strategy.json` を作成し、`docs/artic-strategy.md` を保存してから compiler を実行し、`DESIGN.md` と補助文書を生成します。
7. `@artic show` で strategy artifacts に基づく asset-first visual draft bundle を `.artic/show/` にレンダリングし、アプリのソースファイルは変更しません。
8. `@artic review` で実装を `.artic/strategy.json`、`docs/artic-strategy.md`、`DESIGN.md` と比較し、生成されたデザイン文書を検証します。

## When To Use It

Expand All @@ -146,8 +139,6 @@ Artic が呼び出されると、エージェントは次を行います:
| デザインヒアリング開始 | `@artic init` |
| 高速ヒアリング実行 | `@artic init quick` |
| strategy 作成と文書コンパイル | `@artic start` |
| strategy artifacts から asset-first preview bundle をレンダリング | `@artic show` |
| strategy + `DESIGN.md` に対して実装をレビュー | `@artic review the homepage against DESIGN.md` |
| インストール済み/最新バージョン確認 | `@artic version` |
| 安全な更新コマンド表示 | `@artic update` |

Expand All @@ -172,14 +163,6 @@ DESIGN.md
docs/design-rules.md
docs/design-qa-checklist.md
docs/homepage-design-prompt.md
.artic/show/index.html
.artic/show/styles.css
.artic/show/tokens.json
.artic/show/assets/manifest.json # asset provenance; 未検証 asset は preview-only で production-cleared ではありません
.artic/show/report.json
.artic/show/critique.md
.artic/show/selected.json
.artic/show/iterations/<NNN>/... # @artic show が生成。アプリファイルは変更しません
```

## Repository Layout
Expand Down
23 changes: 3 additions & 20 deletions README.ko.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,11 +21,9 @@ Artic은 구현 전에 홈페이지 디자인 방향을 계약으로 고정하
```text
@artic init # 의도와 레퍼런스 수집
@artic start # strategy artifacts를 작성한 뒤 DESIGN.md 문서 컴파일
@artic show # 출처가 기록된 asset-first preview bundle 렌더링
@artic review # 구현 결과를 문서 기준으로 검토
```

에이전트는 내부에서 사용자 인터뷰, brief 검색 facet 정규화, 전문/오픈소스 디자인 레퍼런스 검색, `.artic/strategy.json` 작성, `DESIGN.md`와 보조 문서 컴파일, 출력 검증을 처리합니다. 스크립트는 validator/compiler/renderer helper이며, 디자인 판단이나 strategy authorship을 대체하지 않습니다.
에이전트는 내부에서 사용자 인터뷰, brief 검색 facet 정규화, 전문/오픈소스 디자인 레퍼런스 검색, `.artic/strategy.json` 작성, `DESIGN.md`와 보조 문서 컴파일, 출력 검증을 처리합니다. 스크립트는 validator/compiler helper이며, 디자인 판단이나 strategy authorship을 대체하지 않습니다.

> Artic은 레퍼런스 사이트를 **복제하지 않습니다**. 전문/OSS 디자인 시스템에서 재사용 가능한 원칙을 추출하고, 프로젝트 맞춤 strategy와 AI-native 문서에 구현을 묶습니다.

Expand All @@ -45,7 +43,6 @@ marketplace 패키지 설치:
```text
/claude-artic:artic init
/claude-artic:artic start
/claude-artic:artic show
```

자연어로도 요청할 수 있습니다:
Expand All @@ -65,7 +62,7 @@ codex plugin marketplace add baskduf/artic
안정적인 설치가 필요하면 릴리즈 태그로 고정:

```bash
codex plugin marketplace add baskduf/artic@v0.4.1
codex plugin marketplace add baskduf/artic@v0.5.0
```

플러그인 브라우저에서 `codex-artic` 설치:
Expand All @@ -85,7 +82,6 @@ Codex에 요청:
```text
@artic init
@artic start
@artic show
```

### Local checkout fallback
Expand All @@ -104,12 +100,11 @@ python3 skills/artic/scripts/synthesize_reference_notes.py --query "ai product d
python3 skills/artic/scripts/synthesize_reference_notes.py --query "ai product developer saas" --limit 3 --live-fetch --cache-dir /tmp/artic-cache --fixtures-dir /tmp/no-fixtures --output /tmp/artic-smoke/docs/live-reference-synthesis.md
python3 skills/artic/scripts/scaffold_artic_files.py --root /tmp/artic-smoke
python3 skills/artic/scripts/validate_artic_outputs.py --root /tmp/artic-smoke
python3 skills/artic/scripts/artic_show.py --root .
python3 skills/artic/scripts/artic_version.py --root .
python3 skills/artic/scripts/artic_update.py --root .
```

Helper scripts는 deterministic helper입니다. `validate_artic_outputs.py`는 contract를 검증하고, `artic_start.py`는 agent-authored strategy를 문서로 컴파일하며, `artic_show.py`는 preview를 렌더링합니다. 디자인 판단의 출처는 스크립트가 아니라 public `@artic start` agent workflow가 작성한 `.artic/strategy.json`입니다.
Helper scripts는 deterministic helper입니다. `validate_artic_outputs.py`는 contract를 검증하고, `artic_start.py`는 agent-authored strategy를 문서로 컴파일합니다. 디자인 판단의 출처는 스크립트가 아니라 public `@artic start` agent workflow가 작성한 `.artic/strategy.json`입니다.

## What Changes In The Agent

Expand All @@ -121,8 +116,6 @@ Artic이 호출되면 에이전트는 다음을 수행합니다:
4. 색상 역할, 타이포그래피, spacing, 컴포넌트, 모션, 접근성 규칙을 추출합니다.
5. 사용자 목표를 기준으로 레퍼런스 간 충돌을 해결합니다.
6. `@artic start`에서 public agent workflow가 `.artic/strategy.json`을 작성하고 `docs/artic-strategy.md`를 저장한 뒤 compiler를 실행해 `DESIGN.md`와 보조 문서를 생성합니다.
7. `@artic show`로 strategy artifacts 기반의 asset-first 시각 초안 bundle을 `.artic/show/` 아래 렌더링하며 앱 소스 파일은 바꾸지 않습니다.
8. `@artic review`로 구현을 `.artic/strategy.json`, `docs/artic-strategy.md`, `DESIGN.md`와 비교하고 생성 문서를 검증합니다.

## When To Use It

Expand All @@ -146,8 +139,6 @@ Artic이 호출되면 에이전트는 다음을 수행합니다:
| 디자인 인터뷰 시작 | `@artic init` |
| 빠른 인터뷰 실행 | `@artic init quick` |
| strategy 작성 및 문서 컴파일 | `@artic start` |
| strategy artifacts 기반 asset-first preview bundle 렌더링 | `@artic show` |
| strategy + `DESIGN.md` 기준 구현 결과 검토 | `@artic review the homepage against DESIGN.md` |
| 설치/최신 버전 확인 | `@artic version` |
| 안전한 업데이트 명령 출력 | `@artic update` |

Expand All @@ -174,14 +165,6 @@ DESIGN.md
docs/design-rules.md
docs/design-qa-checklist.md
docs/homepage-design-prompt.md
.artic/show/index.html
.artic/show/styles.css
.artic/show/tokens.json
.artic/show/assets/manifest.json # asset 출처 기록; 미검증 asset은 preview-only이며 production-cleared가 아님
.artic/show/report.json
.artic/show/critique.md
.artic/show/selected.json
.artic/show/iterations/<NNN>/... # @artic show가 생성; 앱 파일은 변경하지 않음
```

## Repository Layout
Expand Down
23 changes: 3 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,11 +21,9 @@ It keeps the public workflow small:
```text
@artic init # collect intent and references
@artic start # author strategy artifacts, then compile DESIGN.md docs
@artic show # render a provenance-recorded asset-first preview bundle
@artic review # check implementation against the docs
```

The agent handles the design-direction work: interview the user, normalize the brief into search facets, search professional/open-source design references, author `.artic/strategy.json`, compile it into `DESIGN.md` and supporting docs, then validate the output. Scripts are validator/compiler/renderer helpers; they do not replace the agent's design judgment or strategy authorship.
The agent handles the design-direction work: interview the user, normalize the brief into search facets, search professional/open-source design references, author `.artic/strategy.json`, compile it into `DESIGN.md` and supporting docs, then validate the output. Scripts are validator/compiler helpers; they do not replace the agent's design judgment or strategy authorship.

> Artic does **not** clone reference sites. It extracts reusable principles from professional and OSS design systems, then binds implementation to project-specific strategy and AI-native docs.

Expand All @@ -45,7 +43,6 @@ Run the bundled skill:
```text
/claude-artic:artic init
/claude-artic:artic start
/claude-artic:artic show
```

Or ask naturally:
Expand All @@ -65,7 +62,7 @@ codex plugin marketplace add baskduf/artic
Pin a released version when you want a stable install:

```bash
codex plugin marketplace add baskduf/artic@v0.4.1
codex plugin marketplace add baskduf/artic@v0.5.0
```

Install `codex-artic` from the plugin browser:
Expand All @@ -85,7 +82,6 @@ Then ask Codex:
```text
@artic init
@artic start
@artic show
```

### Local checkout fallback
Expand All @@ -104,12 +100,11 @@ python3 skills/artic/scripts/synthesize_reference_notes.py --query "ai product d
python3 skills/artic/scripts/synthesize_reference_notes.py --query "ai product developer saas" --limit 3 --live-fetch --cache-dir /tmp/artic-cache --fixtures-dir /tmp/no-fixtures --output /tmp/artic-smoke/docs/live-reference-synthesis.md
python3 skills/artic/scripts/scaffold_artic_files.py --root /tmp/artic-smoke
python3 skills/artic/scripts/validate_artic_outputs.py --root /tmp/artic-smoke
python3 skills/artic/scripts/artic_show.py --root .
python3 skills/artic/scripts/artic_version.py --root .
python3 skills/artic/scripts/artic_update.py --root .
```

Helper scripts are deterministic helpers: `validate_artic_outputs.py` validates contracts, `artic_start.py` compiles agent-authored strategy into docs, and `artic_show.py` renders previews. They are not the source of design judgment; the public `@artic start` agent workflow supplies that judgment in `.artic/strategy.json`.
Helper scripts are deterministic helpers: `validate_artic_outputs.py` validates contracts, and `artic_start.py` compiles agent-authored strategy into docs. They are not the source of design judgment; the public `@artic start` agent workflow supplies that judgment in `.artic/strategy.json`.

## What Changes In The Agent

Expand All @@ -121,8 +116,6 @@ When invoked, Artic asks the agent to:
4. Extract reusable rules: color roles, type hierarchy, spacing rhythm, components, motion, accessibility.
5. Resolve conflicts between references based on the user's project goal.
6. Run `@artic start` so the public agent workflow authors `.artic/strategy.json`, writes `docs/artic-strategy.md`, then runs the compiler for `DESIGN.md` and supporting docs.
7. Run `@artic show` to render a provenance-recorded asset-first visual draft bundle under `.artic/show/` without changing app source files.
8. Run `@artic review` to compare implementation against `.artic/strategy.json`, `docs/artic-strategy.md`, and `DESIGN.md`, then validate the generated design docs before implementation.

## When To Use It

Expand All @@ -146,8 +139,6 @@ Skip it for:
| Start the design interview | `@artic init` |
| Run the fast interview | `@artic init quick` |
| Author strategy and compile docs | `@artic start` |
| Render an asset-first preview bundle from strategy artifacts | `@artic show` |
| Review implementation against strategy + `DESIGN.md` | `@artic review the homepage against DESIGN.md` |
| Check installed/latest version | `@artic version` |
| Print safe update commands | `@artic update` |

Expand All @@ -174,14 +165,6 @@ DESIGN.md
docs/design-rules.md
docs/design-qa-checklist.md
docs/homepage-design-prompt.md
.artic/show/index.html
.artic/show/styles.css
.artic/show/tokens.json
.artic/show/assets/manifest.json # asset provenance; unverified assets are preview-only, not production-cleared
.artic/show/report.json
.artic/show/critique.md
.artic/show/selected.json
.artic/show/iterations/<NNN>/... # generated by @artic show; app files unchanged
```

## Repository Layout
Expand Down
Loading