Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
154 commits
Select commit Hold shift + click to select a range
1c8a285
feat: add cross-diagram drilldown navigation
zero-qinn Sep 3, 2026
860c4ca
chore: add drilldown HTML examples and refresh generated artifacts
zero-qinn Sep 3, 2026
4e2d3fb
fix: use English copy in drilldown examples for visual captures
zero-qinn Sep 3, 2026
bc3108e
feat: add href sugar and single-child SVG drilldown links
zero-qinn Sep 7, 2026
5aeb586
feat(viewer): authored node explanations in the semantic passport
cilladev Sep 12, 2026
12a3a31
fix(viewer): add back button to explanation panel
cilladev Sep 12, 2026
5c0f0f9
fix(changelog): update changelog
cilladev Sep 12, 2026
be1c26c
feat(examples): add AI agent n8n architecture demo
Copilot Sep 16, 2026
f77d27e
fix(examples): correct n8n memory flow labels
Copilot Sep 16, 2026
b46fc37
test: run the suite green on Windows
techaboo Sep 18, 2026
dea589d
feat(viewer): make intent-trace-flow animation loop continuously
Sep 19, 2026
1f48c52
chore: regenerate trace-enabled HTML artifacts from current viewer CSS
Sep 19, 2026
fd60cc0
chore: regenerate all artifacts and metadata after rebase onto dev
Sep 21, 2026
3ad2b34
chore: rebuild archify.zip and regenerate astron visual-check evidence
Sep 21, 2026
0a2122f
fix(compare): classify authored translation changes
To3akaRin Sep 28, 2026
fea93f2
fix(brands): validate WebP container image data
To3akaRin Sep 28, 2026
f15481a
docs(references): document brand URL as the network trust boundary
rollroyces Sep 28, 2026
3e9bb54
docs(renderers): document the atomic-output capture→verify→publish pr…
rollroyces Sep 28, 2026
8494431
fix(lock): fail delivery-lock liveness check closed on every non-succ…
rollroyces Sep 28, 2026
94059ef
docs(renderers): correct capture/verify/remove contract in atomic-out…
rollroyces Sep 28, 2026
c79a6ab
docs(references): clarify trust boundary for redirects and favicon hrefs
rollroyces Sep 28, 2026
e98b8e4
fix(lock): map only ESRCH to lock-stale; treat EPERM as concurrent-at…
rollroyces Sep 28, 2026
30609e9
Merge development base and preserve PR #603 fix
To3akaRin Sep 29, 2026
7673819
Merge development base and preserve PR #605 fix
To3akaRin Sep 29, 2026
76a0097
Merge current development identity and rebuild PR 603 package
To3akaRin Sep 29, 2026
cf68bab
Merge verified development baseline into WebP bounds fix
To3akaRin Sep 29, 2026
e135e46
Merge development website identity follow-up
To3akaRin Sep 29, 2026
dd20477
Merge development website identity follow-up
To3akaRin Sep 29, 2026
87fb88f
fix(examples): improve n8n demo readability
Copilot Sep 29, 2026
9dc8bcd
feat(i18n): complete the French example catalog
psl75011 Oct 5, 2026
bee1a67
test(preview): verify HEAD representation metadata
rudycelekli Oct 10, 2026
19efbfe
fix(viewer): retain keyboard focus after fallback link copy
rudycelekli Oct 10, 2026
ff21581
test(preview): allow bounded readiness wait before HEAD assertions
rudycelekli Oct 11, 2026
0f47192
Merge current dev and adapt translation comparison regression
To3akaRin Oct 15, 2026
3c43d22
Merge current dev preserving WebP and ICO validation
To3akaRin Oct 15, 2026
6c744b2
fix(compare): treat empty translation catalogs as omitted
To3akaRin Oct 15, 2026
c645215
feat(site): add class, tree, timeline, and waterfall promoted-type re…
hemv-857 Oct 17, 2026
d51fd25
fix(site): add promoted-type filters to the generated gallery template
hemv-857 Oct 18, 2026
9ac7a0c
chore: rebuild canonical archify.zip with promoted-type recipes
hemv-857 Oct 18, 2026
e8738f5
fix(site): derive gallery deep-link filter allowlist from filter buttons
hemv-857 Oct 18, 2026
f132f0e
fix(guide): derive the typed-mode metric from recipe data instead of …
hemv-857 Oct 18, 2026
8f93c78
ci: retrigger verification for review-feedback commits
hemv-857 Oct 18, 2026
4ccc1cc
merge: integrate dev into promoted-type recipes branch, rebuild canon…
hemv-857 Oct 18, 2026
1650c71
Merge remote-tracking branch 'origin/dev' into feat/916-promoted-type…
hemv-857 Oct 19, 2026
72c35f2
Merge remote-tracking branch 'origin/dev' into feat/916-promoted-type…
hemv-857 Oct 20, 2026
fc06f42
fix(renderers): print the whole layout report when stdout is a pipe
sx4im Oct 20, 2026
2aaff1f
merge: integrate dev into promoted-type recipes branch, rebuild canon…
hemv-857 Oct 20, 2026
23e9945
Merge remote-tracking branch 'origin/dev' into fix/1020-layout-json-p…
sx4im Oct 20, 2026
30177b3
fix(viewer): keep non-Latin letters in export filenames
sx4im Oct 20, 2026
b29fa4a
fix(story): keep flowless guides out of the opening clock
cursoragent Oct 21, 2026
978f774
fix(viewer): drop detached marks from export filenames and refresh ca…
sx4im Oct 21, 2026
08fd04b
fix(viewer): keep a tall diagram's top in frame when zooming out
sx4im Oct 21, 2026
19b8486
feat: add agent install brief and contributors wall
cursoragent Oct 24, 2026
6b1c4ba
fix(explainer): retain literal heading separators without crashing
tt-a1i Oct 25, 2026
1addca2
Merge latest dev into layout JSON pipe fix
tt-a1i Oct 25, 2026
8803425
test: preserve literal paths in layout pipe regression
tt-a1i Oct 25, 2026
cf8cbe1
fix(explainer): omit private patch input bindings from shared pages
tt-a1i Oct 25, 2026
38e3760
fix(explainer): guide treeView fences to native tree shorthand
tt-a1i Oct 25, 2026
28cb1a1
fix(explainer): preserve patch payload diagnostics
tt-a1i Oct 25, 2026
fe44d9a
fix(onboarding): preserve selected install scope and bound avatar red…
tt-a1i Oct 25, 2026
cd62d50
fix(cli): report indeterminate sidecar namespaces as failed receipts
tt-a1i Oct 25, 2026
2770a01
fix(viewer): restore authored alignment after compact flow
tt-a1i Oct 25, 2026
a3a17c3
Merge dev into PR 862 and rebuild combined viewer artifacts
tt-a1i Oct 25, 2026
47b0ee8
Merge dev into PR 1039 and rebuild combined viewer artifacts
tt-a1i Oct 25, 2026
b228f3c
Merge dev into PR 1051 and rebuild camera alignment artifacts
tt-a1i Oct 25, 2026
11b06a1
fix(viewer): complete the global IME shortcut boundary
tt-a1i Oct 25, 2026
d0387e2
fix(export): preserve ASCII underscore filename compatibility
tt-a1i Oct 25, 2026
cc15c2a
test(delivery): protect uncertain lock owners through the public CLI
tt-a1i Oct 25, 2026
a143350
Merge dev into PR 1047 while preserving the flowless opening fix
tt-a1i Oct 25, 2026
7c09acf
Merge current dev into brand trust-boundary documentation
tt-a1i Oct 25, 2026
c7d1fc2
Merge current dev and align atomic-output reference with binding cont…
tt-a1i Oct 25, 2026
337c767
fix(delivery): preserve local Explainer inputs before sidecar writes
tt-a1i Oct 25, 2026
154ba94
ci: request checks for delivery lock regression on dev
tt-a1i Oct 25, 2026
89d703e
test(preview): close HEAD fixtures when request deadlines expire
tt-a1i Oct 25, 2026
97be7a1
fix(delivery): refuse evidence from rejected prepared inputs
tt-a1i Oct 25, 2026
084432a
docs: bound atomic publication guarantees to active bindings
tt-a1i Oct 25, 2026
323b319
fix(explainer): localize automatic workflow branch labels
tt-a1i Oct 25, 2026
1066c0e
Merge latest dev into WebP container bounds fix
tt-a1i Oct 25, 2026
2ad3f32
test(windows): retain the remaining portable Git configuration fix
tt-a1i Oct 25, 2026
49219ff
Merge current dev and package completed French example catalog
tt-a1i Oct 25, 2026
60e15ef
test: keep French coverage fixture independent of catalog growth
tt-a1i Oct 25, 2026
f4e5b81
Merge current dev into translation comparison fix and rebuild package
tt-a1i Oct 25, 2026
ed16f16
Merge dev and complete promoted recipe entry points and proof facts
tt-a1i Oct 25, 2026
6c3db65
Merge dev into PR 481 and verify active Live trace lifecycle
tt-a1i Oct 25, 2026
cd0d075
ci(windows): exercise repository replacement fixtures on the native host
tt-a1i Oct 25, 2026
c637e53
Merge current dev and refresh the illustrative n8n example artifact
tt-a1i Oct 25, 2026
1d403d8
fix(recipes): describe promoted proofs actual Viewer motion
tt-a1i Oct 25, 2026
b63705e
Merge current dev and preserve reader context across sibling navigation
tt-a1i Oct 25, 2026
d858176
Merge current dev into #398 and bound Passport explanations to the vi…
tt-a1i Oct 25, 2026
9191b2a
fix(viewer): retain authored drilldown links and marks in exports
tt-a1i Oct 25, 2026
8b0fe88
fix(examples): fit drilldown sequence and regenerate showcase delta
tt-a1i Oct 25, 2026
63290b8
fix(explainer): preserve authored lines through pie normalization
tt-a1i Oct 25, 2026
5f012ab
test(explainer): wait for modal close before refocusing steps
tt-a1i Oct 25, 2026
82cd75c
Merge dev Apache baseline into PR #1088
tt-a1i Oct 25, 2026
3d62242
Merge dev Apache baseline into PR #1089
tt-a1i Oct 25, 2026
191862f
Merge dev Apache baseline into PR #1090
tt-a1i Oct 25, 2026
990744e
Merge Apache-licensed dev into French example catalog
tt-a1i Oct 25, 2026
76a3bcd
Merge current dev licensing into layout JSON pipe fix
tt-a1i Oct 25, 2026
af1ffda
Merge dev Apache baseline into PR #1091
tt-a1i Oct 25, 2026
dbb4791
Merge dev Apache licensing baseline into copy focus fix
tt-a1i Oct 25, 2026
637f07b
Merge commit '3f95f0349c8276db71509ca239461b6fe9d00f9f' into merge-lo…
tt-a1i Oct 25, 2026
16a1ef1
Merge dev Apache baseline into PR #1092
tt-a1i Oct 25, 2026
8ad4e22
Merge dev Apache baseline into PR #1094
tt-a1i Oct 25, 2026
f8216e4
Merge Apache dev and retain notices in the n8n example
tt-a1i Oct 25, 2026
1e37c5e
Merge dev Apache baseline into PR #1095
tt-a1i Oct 25, 2026
04dcc1a
Merge commit '3f95f0349c8276db71509ca239461b6fe9d00f9f' into merge-lo…
tt-a1i Oct 25, 2026
1adc6c3
Merge dev Apache baseline into PR #1097
tt-a1i Oct 25, 2026
d5c535f
Merge dev Apache licensing baseline into PR 1051
tt-a1i Oct 25, 2026
1b789a4
docs(llms): reflect the current Apache license
tt-a1i Oct 25, 2026
a425145
Merge PR #1088 into maintenance integration
tt-a1i Oct 25, 2026
42dea72
Merge PR #1089 into maintenance integration
tt-a1i Oct 25, 2026
11806b3
Merge PR #1090 into maintenance integration
tt-a1i Oct 25, 2026
4a73614
Merge PR #1091 into maintenance integration
tt-a1i Oct 25, 2026
df45c31
Merge PR #1092 into maintenance integration
tt-a1i Oct 25, 2026
cecd0b3
Merge current dev licensing into brand trust-boundary reference
tt-a1i Oct 25, 2026
268783a
Merge Apache dev and regenerate promoted recipe proofs with notices
tt-a1i Oct 25, 2026
d0f2d70
Merge PR #1094 preserving source-repair rollback and input protection
tt-a1i Oct 25, 2026
7698835
Merge dev Apache licensing baseline into PR 1039
tt-a1i Oct 25, 2026
b91dae9
Merge current dev licensing into atomic output design reference
tt-a1i Oct 25, 2026
3a645e2
Merge commit '3f95f0349c8276db71509ca239461b6fe9d00f9f' into merge-lo…
tt-a1i Oct 25, 2026
906b3a5
Merge PR #1095 retaining heading and locale regression coverage
tt-a1i Oct 25, 2026
bc71203
Merge PR #1097 into maintenance integration
tt-a1i Oct 25, 2026
6ee2ce2
Merge current dev licensing into WebP container fix
tt-a1i Oct 25, 2026
82faee7
Merge Apache dev into the Story opening clock fix
tt-a1i Oct 25, 2026
45d373e
Merge dev Apache licensing baseline into PR 1093
tt-a1i Oct 25, 2026
32cf21a
Merge PR #1033 into maintenance integration
tt-a1i Oct 25, 2026
68ad89a
Merge PR #1080 into maintenance integration
tt-a1i Oct 25, 2026
67107fd
Merge PR #608 into maintenance integration
tt-a1i Oct 25, 2026
14fac9a
Merge PR #606 into maintenance integration
tt-a1i Oct 25, 2026
3a1a01e
Merge PR #607 into maintenance integration
tt-a1i Oct 25, 2026
ad82931
Merge PR #857 into maintenance integration
tt-a1i Oct 25, 2026
71112ed
Merge PR #605 into maintenance integration
tt-a1i Oct 25, 2026
21d4423
Merge PR #729 into maintenance integration
tt-a1i Oct 25, 2026
e9c9d63
Merge PR #450 into maintenance integration
tt-a1i Oct 25, 2026
c18308f
Merge PR #986 into maintenance integration
tt-a1i Oct 25, 2026
e11f5f2
Merge PR #1047 into maintenance integration
tt-a1i Oct 25, 2026
fc3ad29
Merge PR #862 into maintenance integration
tt-a1i Oct 25, 2026
8eca0fa
Merge PR #1051 into maintenance integration
tt-a1i Oct 25, 2026
2dc5910
Merge PR #1039 into maintenance integration
tt-a1i Oct 25, 2026
b3c5a64
Merge commit '3f95f0349c8276db71509ca239461b6fe9d00f9f' into merge-lo…
tt-a1i Oct 25, 2026
c5575ca
Merge current software notices into Delta translation projection fix
tt-a1i Oct 25, 2026
b65db11
Merge dev Apache licensing baseline into PR 481
tt-a1i Oct 25, 2026
1dc8366
Merge PR #465 into maintenance integration
tt-a1i Oct 25, 2026
87558b9
Merge PR #603 retaining both independent changelog entries
tt-a1i Oct 25, 2026
74cd024
Merge PR #1093 into maintenance integration
tt-a1i Oct 25, 2026
8bc17f9
Merge PR #481 into maintenance integration
tt-a1i Oct 25, 2026
8de1fe7
Merge dev Apache licensing baseline into PR 398
tt-a1i Oct 25, 2026
f6d3d23
Merge PR #398 into maintenance integration
tt-a1i Oct 25, 2026
cb13e45
Merge dev Apache licensing baseline into PR 281
tt-a1i Oct 25, 2026
d5f997b
Merge PR #281 preserving combined Viewer contracts
tt-a1i Oct 25, 2026
50cf668
Restore complete Viewer and inventory tails after integration conflic…
tt-a1i Oct 25, 2026
d24526a
Fix combined Passport readability and focus in short viewports
tt-a1i Oct 25, 2026
3b5b16c
Rebuild combined maintenance artifacts and verified package
tt-a1i Oct 25, 2026
98efbfc
Separate n8n example return routes and labels
tt-a1i Oct 25, 2026
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
30 changes: 30 additions & 0 deletions .github/workflows/contributors.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
name: Contributors

on:
schedule:
# Weekly, after the Monday star-history refresh, so the two publishers do not overlap.
- cron: '15 5 * * 1'
workflow_dispatch:

permissions:
contents: write

concurrency:
group: contributors-svg
cancel-in-progress: true

jobs:
update:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5.1.0
- uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5.0.0
with:
node-version: 22
- name: Render contributors wall
env:
GH_TOKEN: ${{ github.token }}
run: node scripts/generate-contributors-svg.mjs --out "$RUNNER_TEMP/contributors.svg"
- name: Publish wall with linear history
run: bash scripts/publish-contributors-svg.sh contributors "$RUNNER_TEMP/contributors.svg"
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,16 @@ All notable changes are documented here. Format loosely follows [Keep a Changelo

> Development identity: `v3.2.1-dev.1`. Not a stable release.

### Added
- **Authored node explanations in the Semantic Passport.** Architecture, Workflow, Sequence, Dataflow and Lifecycle nodes may carry optional plain-text explanations up to1200 characters. Explain opens a viewport-bounded reading face with scrollable prose and a reachable Back action; Escape restores the Passport. Prose remains outside canonical SVG and visual exports, and existing diagram geometry is preserved.
- **Cross-diagram navigation.** Nodes may list sibling `.html` targets via `drilldowns` or a one-entry `href` shorthand. One child uses a native SVG link and visible mark (click follows, Alt-click focuses). Several children keep click-to-focus, with Passport listing every target and Ctrl/double-click opening the first. Child pages can author `meta.parentHref` for header Back; the Viewer also accepts `?from=`.

### Fixed

- **WebP brand container bounds (#602).** Reject missing or out-of-bounds image chunks, including incomplete animation frames, before reporting capture or pinned validation success. Preserve valid lossy, lossless, extended and animated containers and original-byte digests.

- **Architecture Delta translation changes (#600).** Compare reports additions, removals and edits to `meta.translations` as presentation changes; translation-key order and empty-versus-omitted catalogs do not affect presentation classification or entity-change counts.

- **Explainer chart data (#1008, #1011).** Preserve quotes and backslashes in labels, parse quoted multiline CSV records, and normalize ordinary display whitespace without rewriting source data. Malformed records, missing values and unsupported control characters still fail before replacing an existing delivery.

- Viewer toolbar arrow-key and Home/End navigation includes visible Style and Export triggers (#899).
Expand Down
36 changes: 32 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,12 @@ Works with Cursor, Claude Code, Codex CLI, and OpenCode. See installation option
npx skills add tt-a1i/archify -g
```

**With an AI agent.** Paste this:

```text
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt
```

Send this to your agent:

```text
Expand Down Expand Up @@ -223,15 +229,31 @@ Open [`examples/web-app.html`](examples/web-app.html) locally to try the complet
npx skills add tt-a1i/archify -g
```

<details>
<summary>More installation options and update-check details</summary>
**With an AI agent**

Paste this to your agent:

```text
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt
```

Or install without prompts. Pass one agent, or repeat `--agent` for every switcher target (`cursor`, `codex`, `claude-code`, `opencode`, `github-copilot`). `--copy` copies the skill instead of symlinking:

For an explicit, non-interactive Cursor install:
Cursor only:

```bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
```

Or, only if you want all five agents:

```bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --agent codex --agent claude-code --agent opencode --agent github-copilot --global --copy --yes
```

<details>
<summary>More installation options and update-check details</summary>

To try without installing:

```bash
Expand All @@ -240,7 +262,7 @@ npx skills use tt-a1i/archify@archify --agent codex

[DSH community opt-in](integrations/deepseek-harness/README.md): `dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0`

The [agent switcher](https://archify.si/start.html?agent=cursor&type=architecture) covers `cursor`, `codex`, `claude-code`, and `opencode`.
The [agent switcher](https://archify.si/start.html?agent=cursor&type=architecture) covers `cursor`, `codex`, `claude-code`, `opencode`, and `github-copilot`.

Archify may GET the fixed stable manifest solely to show an optional reminder; it never downloads or installs updates. Successful checks wait about 24 hours (±20%); active use retries failures after 6, then 24 hours. The server sees normal HTTP metadata (IP and time), but receives no version, Agent, project data, prompts, account/device ID, or ETag. You decide whether and when to update. Set `ARCHIFY_UPDATE_CHECK_DISABLED=1` to disable networking and reminder-state writes.

Expand Down Expand Up @@ -522,6 +544,12 @@ Scan the QR code below with Alipay, or save it and open it in Alipay to scan.

Using Archify, sharing it, reporting bugs, and contributing improvements are also ways to help.

## Contributors

Thanks to everyone who helped build Archify. [Go follow them.](https://github.com/tt-a1i/archify/graphs/contributors) ❤️

<p align="center"><a href="https://github.com/tt-a1i/archify/graphs/contributors"><img alt="Archify contributors" src="https://raw.githubusercontent.com/tt-a1i/archify/contributors/contributors.svg" width="1000" /></a></p>

## Star History

<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-dark.svg" /><img alt="Star History" src="https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-light.svg" /></picture></p>
36 changes: 32 additions & 4 deletions README_EN.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,12 @@ Works with Cursor, Claude Code, Codex CLI, and OpenCode. See installation option
npx skills add tt-a1i/archify -g
```

**With an AI agent.** Paste this:

```text
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt
```

Send this to your agent:

```text
Expand Down Expand Up @@ -223,15 +229,31 @@ Open [`examples/web-app.html`](examples/web-app.html) locally to try the complet
npx skills add tt-a1i/archify -g
```

<details>
<summary>More installation options and update-check details</summary>
**With an AI agent**

Paste this to your agent:

```text
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt
```

Or install without prompts. Pass one agent, or repeat `--agent` for every switcher target (`cursor`, `codex`, `claude-code`, `opencode`, `github-copilot`). `--copy` copies the skill instead of symlinking:

For an explicit, non-interactive Cursor install:
Cursor only:

```bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
```

Or, only if you want all five agents:

```bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --agent codex --agent claude-code --agent opencode --agent github-copilot --global --copy --yes
```

<details>
<summary>More installation options and update-check details</summary>

To try without installing:

```bash
Expand All @@ -240,7 +262,7 @@ npx skills use tt-a1i/archify@archify --agent codex

[DSH community opt-in](integrations/deepseek-harness/README.md): `dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0`

The [agent switcher](https://archify.si/start.html?agent=cursor&type=architecture) covers `cursor`, `codex`, `claude-code`, and `opencode`.
The [agent switcher](https://archify.si/start.html?agent=cursor&type=architecture) covers `cursor`, `codex`, `claude-code`, `opencode`, and `github-copilot`.

Archify may GET the fixed stable manifest solely to show an optional reminder; it never downloads or installs updates. Successful checks wait about 24 hours (±20%); active use retries failures after 6, then 24 hours. The server sees normal HTTP metadata (IP and time), but receives no version, Agent, project data, prompts, account/device ID, or ETag. You decide whether and when to update. Set `ARCHIFY_UPDATE_CHECK_DISABLED=1` to disable networking and reminder-state writes.

Expand Down Expand Up @@ -522,6 +544,12 @@ Scan the QR code below with Alipay, or save it and open it in Alipay to scan.

Using Archify, sharing it, reporting bugs, and contributing improvements are also ways to help.

## Contributors

Thanks to everyone who helped build Archify. [Go follow them.](https://github.com/tt-a1i/archify/graphs/contributors) ❤️

<p align="center"><a href="https://github.com/tt-a1i/archify/graphs/contributors"><img alt="Archify contributors" src="https://raw.githubusercontent.com/tt-a1i/archify/contributors/contributors.svg" width="1000" /></a></p>

## Star History

<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-dark.svg" /><img alt="Star History" src="https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-light.svg" /></picture></p>
36 changes: 32 additions & 4 deletions README_JA.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,12 @@ Cursor、Claude Code、Codex CLI、OpenCode で利用できます。その他の
npx skills add tt-a1i/archify -g
```

**AI エージェントに任せる。** 次の文をそのまま貼り付けてください:

```text
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt
```

エージェントにこう送ってください:

```text
Expand Down Expand Up @@ -197,15 +203,31 @@ Export メニューから PNG をクリップボードにコピーしたり、
npx skills add tt-a1i/archify -g
```

<details>
<summary>その他のインストール方法と更新チェックの詳細</summary>
**AI エージェントに任せる**

次の文をそのまま貼り付けてください:

```text
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt
```

確認なしでインストールすることもできます。`--agent` は 1 つ、または切り替え対象ごとに繰り返します(`cursor`、`codex`、`claude-code`、`opencode`、`github-copilot`)。`--copy` はシンボリックリンクではなくファイルをコピーします:

Cursor に明示的・非対話的にインストールする場合:
Cursor のみにインストールする場合:

```bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
```

または、5 つすべてのエージェントが必要な場合のみ:

```bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --agent codex --agent claude-code --agent opencode --agent github-copilot --global --copy --yes
```

<details>
<summary>その他のインストール方法と更新チェックの詳細</summary>

インストールせずに試す場合:

```bash
Expand All @@ -214,7 +236,7 @@ npx skills use tt-a1i/archify@archify --agent codex

[DSH コミュニティ版(任意)](integrations/deepseek-harness/README.md): `dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0`

[エージェント切り替え](https://archify.si/start.html?agent=cursor&type=architecture)は `cursor`、`codex`、`claude-code`、`opencode` に対応しています。
[エージェント切り替え](https://archify.si/start.html?agent=cursor&type=architecture)は `cursor`、`codex`、`claude-code`、`opencode`、`github-copilot` に対応しています。

Archify は固定の安定版マニフェストを GET して任意の更新リマインダーを表示することがありますが、更新をダウンロードしたりインストールしたりすることはありません。チェックに成功すると次回まで約 24 時間(±20%)待機し、失敗した場合はアクティブに使用していれば 6 時間後、その後は 24 時間後に再試行します。サーバーが受け取るのは通常の HTTP メタデータ(IP と時刻)だけで、バージョン、Agent、プロジェクトデータ、プロンプト、アカウント/デバイス ID、ETag は送信されません。更新するかどうか、いつ更新するかは常にあなたが決めます。`ARCHIFY_UPDATE_CHECK_DISABLED=1` を設定すると、ネットワーク通信とリマインダー状態の書き込みを無効化できます。

Expand Down Expand Up @@ -486,6 +508,12 @@ Alipay で下の QR コードをスキャンするか、画像を保存して Al

利用、共有、不具合の報告、改善への貢献も、プロジェクトの支えになります。

## コントリビューター

Archify の開発を支えてくれたすべての人に感謝します。[フォローしてみてください。](https://github.com/tt-a1i/archify/graphs/contributors) ❤️

<p align="center"><a href="https://github.com/tt-a1i/archify/graphs/contributors"><img alt="Archify のコントリビューター" src="https://raw.githubusercontent.com/tt-a1i/archify/contributors/contributors.svg" width="1000" /></a></p>

## Star History

<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-dark.svg" /><img alt="Star History" src="https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-light.svg" /></picture></p>
34 changes: 31 additions & 3 deletions README_KO.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,12 @@ Cursor, Claude Code, Codex CLI, OpenCode에서 사용할 수 있습니다.
npx skills add tt-a1i/archify -g
```

**AI 에이전트에게 맡기기.** 다음 문장을 그대로 붙여 넣으세요.

```text
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt
```

에이전트에게 다음과 같이 요청하세요.

```text
Expand Down Expand Up @@ -98,15 +104,31 @@ Archify로 한 페이지로 답해 줘: API P99가 80 ms에서 600 ms로 올랐
npx skills add tt-a1i/archify -g
```

<details>
<summary>다른 설치 방법과 업데이트 확인 동작</summary>
**AI 에이전트에게 맡기기**

다음 문장을 그대로 붙여 넣으세요.

```text
Install Archify for me by reading https://raw.githubusercontent.com/tt-a1i/archify/main/llms.txt
```

확인 없이 설치할 수도 있습니다. `--agent`는 하나, 또는 전환 대상마다 반복합니다 (`cursor`, `codex`, `claude-code`, `opencode`, `github-copilot`). `--copy`는 심볼릭 링크 대신 파일을 복사합니다.

비대화형 Cursor 설치:
Cursor에만 설치:

```bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes
```

또는 다섯 에이전트가 모두 필요한 경우에만:

```bash
npx -y skills add tt-a1i/archify --skill archify --agent cursor --agent codex --agent claude-code --agent opencode --agent github-copilot --global --copy --yes
```

<details>
<summary>다른 설치 방법과 업데이트 확인 동작</summary>

설치하지 않고 사용해 보기:

```bash
Expand Down Expand Up @@ -227,6 +249,12 @@ node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --

Issue, Pull Request, 실제 사용 사례 다이어그램을 환영합니다. [기여 가이드](CONTRIBUTING.md)에서 시작하세요. 실패는 재현 가능한 버그 양식으로 제보하고, 검증된 다이어그램은 [커뮤니티 Showcase 양식](https://github.com/tt-a1i/archify/issues/new?template=showcase.yml)으로 제출할 수 있습니다.

## 기여자

Archify를 함께 만들어 준 모든 분께 감사합니다. [팔로우해 보세요.](https://github.com/tt-a1i/archify/graphs/contributors) ❤️

<p align="center"><a href="https://github.com/tt-a1i/archify/graphs/contributors"><img alt="Archify 기여자" src="https://raw.githubusercontent.com/tt-a1i/archify/contributors/contributors.svg" width="1000" /></a></p>

## Star History

<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-dark.svg" /><img alt="Star History" src="https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-light.svg" /></picture></p>
Loading
Loading