Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
docs: keep installation boundaries concise and honor existing authorization
tt-a1i572e260cdbfd
diff --git a/AGENTS.md b/AGENTS.mdindex ec9bcf37..3291bd8b 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -1,57 +1,13 @@-# AGENTS.md+# Agent instructions-Instructions for coding agents working on this repository.+Follow [CONTRIBUTING.md](CONTRIBUTING.md) for repository changes and [REVIEWING.md](REVIEWING.md) for reviews.-## Installing Archify+## Live Archify installations-Installing, updating, removing, or reinstalling Archify changes live agent-configuration outside this checkout. Do that only when the user names that exact-action directly, such as "install Archify" or "update the global Archify Skill."-An implied need or a request to edit, test, review, commit, push, merge, release,-publish, or sync this repository is not consent.+Install, update, reinstall, or remove a live Archify installation only when the user explicitly requests that action. Repository editing, testing, reviewing, publishing, or syncing does not authorize installation. This applies to Skills CLI, manual ZIP copies, and DSH plugins. Reuse authorization already given for the same action and scope; ask only for unresolved decisions.-Before any live installation mutation:--1. Confirm the exact action, source, agent, and global or project scope. Do not- infer `--all`; use `--yes` only after those values are explicit. A reinstall- is an update/install operation, not permission to remove unrelated paths.-2. For a Skills CLI add, first run- `npx -y skills add tt-a1i/archify --list --full-depth`. This documented- `--list` mode must discover exactly one Skill named `archify`. On a command- error, zero matches, or multiple matches, stop and report the output without- running a mutating command.-3. Install from the canonical `tt-a1i/archify` source. Do not use a path under a- system temporary directory, a Git worktree, or another session-scoped- checkout as a local package source. A deliberate local-source install may- use a clean, durable checkout only when the user explicitly asks for it;- prefer `--copy` unless they explicitly request managed symlinks.-4. Before a manual copy or extraction, fail if the destination exists; report- the exact path and never delete or replace it unless the user explicitly- approves that named path after seeing the conflict. For Skills CLI and- package-manager operations, use their own conflict handling,- never add an unrequested force flag, and report every skipped, replaced, or- failed destination.-5. Afterward, report the exact command, source, action, skill or package, agent,- scope, and result. Never describe a partial installation as success.--For `skills update`, name `archify` and pass `--global` or `--project` explicitly;-do not run an unscoped bulk update. For `skills remove`, name `archify`, specify-its scope and requested agents, and never use `--all`. Manual `archify.zip`-extraction, Claude.ai upload, DSH plugin add/remove, and package-manager-installation follow the same action/scope confirmation and reporting rules; use-the documented exact destination or package version and preserve unrelated-files. The Skill's update checker is notification-only, so an update notice-never authorizes installation.--## Repository workflow--Follow [`CONTRIBUTING.md`](CONTRIBUTING.md) for planning, compatibility,-validation, generated artifacts, and pull-request evidence. In particular:--- start from the latest `main` and keep one behavior per pull request;-- run the narrowest relevant test first and `npm test` from `archify/` before- final review;-- rebuild `archify.zip` only when packaged Skill bytes change;-- do not claim remote CI passed unless it ran on the current head;-- never include secrets, private repository content, personal data, or customer- data in repository artifacts.+- Keep the source, Skill/package, target agents, and global/project scope within the request. Avoid bulk operations or force flags that expand that scope. An update notification is informational.+- Before a Skills CLI install, run `npx -y skills add tt-a1i/archify --list --full-depth` and verify exactly one Skill named `archify`. Stop on failed or ambiguous discovery.+- Use the canonical remote source by default. Use a local source only when requested, from a durable checkout; live symlinks must not point into temporary directories or disposable worktrees.+- Preserve unrelated files and existing unmanaged destinations. Report a destination conflict before replacing it unless that exact replacement is already explicitly authorized; use the installer's documented conflict handling within the approved scope.+- Report the action, source, targets, and result, including skipped or failed destinations. A partial installation is not a complete success.diff --git a/CLAUDE.md b/CLAUDE.mdindex 1024897d..1f02e0c9 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -1,5 +1,5 @@# Claude Code instructions-Read and follow [`AGENTS.md`](AGENTS.md).+Follow [AGENTS.md](AGENTS.md).@AGENTS.mddiff --git a/archify/test/agent-install-consent.test.mjs b/archify/test/agent-install-consent.test.mjsdeleted file mode 100644index b7a15940..00000000--- a/archify/test/agent-install-consent.test.mjs+++ /dev/null@@ -1,54 +0,0 @@-import { test } from 'node:test';-import assert from 'node:assert/strict';-import fs from 'node:fs';-import path from 'node:path';-import { fileURLToPath } from 'node:url';--const __dirname = path.dirname(fileURLToPath(import.meta.url));-const repoRoot = path.resolve(__dirname, '..', '..');-const agents = fs.readFileSync(path.join(repoRoot, 'AGENTS.md'), 'utf8');-const claude = fs.readFileSync(path.join(repoRoot, 'CLAUDE.md'), 'utf8');--const discoveryCommand = 'npx -y skills add tt-a1i/archify --list --full-depth';--test('agent installation requires direct action and explicit scope', () => {- assert.match(agents, /only when the user names that exact\s+action directly/i);- assert.match(agents, /implied need[\s\S]*is not consent/i);- assert.match(agents, /exact action, source, agent, and global or project scope/i);- assert.match(agents, /Do not\s+infer `--all`/i);- assert.match(agents, /use `--yes` only after those values are explicit/i);- assert.match(agents, /A reinstall[\s\S]*not permission to remove unrelated paths/i);-});--test('Skills CLI discovery is non-mutating and fails closed', () => {- assert.ok(agents.includes(discoveryCommand));- assert.match(agents, /documented\s+`--list` mode/i);- assert.match(agents, /exactly one Skill named `archify`/i);- assert.match(agents, /command\s+error, zero matches, or multiple matches[\s\S]*stop[\s\S]*without\s+running a mutating command/i);-});--test('local and manual installs preserve unrelated destinations', () => {- assert.match(agents, /canonical `tt-a1i\/archify` source/i);- assert.match(agents, /system temporary directory[\s\S]*Git worktree[\s\S]*session-scoped/i);- assert.match(agents, /prefer `--copy` unless they explicitly request managed symlinks/i);- assert.match(agents, /Before a manual copy or extraction, fail if the destination exists/i);- assert.match(agents, /never delete or replace it unless the user explicitly[\s\S]*approves[\s\S]*named path[\s\S]*conflict/i);- assert.match(agents, /never add an unrequested force flag/i);- assert.match(agents, /Never describe a partial installation as success/i);- assert.match(agents, /exact command, source, action, skill or package, agent,[\s\S]*scope, and result/i);-});--test('updates and removals stay named and scoped', () => {- assert.match(agents, /For `skills update`, name `archify`/i);- assert.match(agents, /pass `--global` or `--project` explicitly/i);- assert.match(agents, /For `skills remove`, name `archify`/i);- assert.match(agents, /specify[\s\S]*scope and requested agents/i);- assert.match(agents, /never use `--all`/i);- assert.match(agents, /Manual `archify\.zip`[\s\S]*Claude\.ai upload[\s\S]*DSH plugin add\/remove/i);- assert.match(agents, /update checker is notification-only[\s\S]*never authorizes installation/i);-});--test('Claude Code inherits the shared root policy with a plaintext fallback', () => {- assert.match(claude, /Read and follow \[`AGENTS\.md`\]\(AGENTS\.md\)/);- assert.match(claude, /^@AGENTS\.md$/m);-});