From 126ec783c3699f3d48132c6e9cad23f03869a425 Mon Sep 17 00:00:00 2001 From: jason Date: Fri, 27 Mar 2026 22:35:35 -0500 Subject: [PATCH] Delete INSTALL.md --- INSTALL.md | 105 ----------------------------------------------------- 1 file changed, 105 deletions(-) delete mode 100644 INSTALL.md diff --git a/INSTALL.md b/INSTALL.md deleted file mode 100644 index 250df3a..0000000 --- a/INSTALL.md +++ /dev/null @@ -1,105 +0,0 @@ -# Install and Copy Guide - -Use this guide to copy the instruction suite into another repository without bloating the destination or confusing the agent. - -## Recommended Install - -Copy these items into the target repository root: - -- `AGENTS.md` -- `DEPLOYMENT-PROFILE.md` -- `SKILLS.md` -- `PROJECT-PROFILE-WORKBOOK.md` -- `ROUTING-EXAMPLES.md` -- `hubs/` -- `skills/` - -Optional: - -- `README.md` if you want human-facing explanation of the bundle in the destination repo - -## Fast Copy Workflow - -From this repository root, copy the suite into another repo root while excluding `.git`: - -```powershell -Copy-Item AGENTS.md,DEPLOYMENT-PROFILE.md,SKILLS.md,PROJECT-PROFILE-WORKBOOK.md,ROUTING-EXAMPLES.md -Destination -Copy-Item hubs -Destination -Recurse -Copy-Item skills -Destination -Recurse -``` - -If you also want the explanatory readme: - -```powershell -Copy-Item README.md -Destination -``` - -## Prefill Workflow - -Before deployment: - -1. Fill out `PROJECT-PROFILE-WORKBOOK.md`. -2. Translate the answers into agent-facing defaults in `DEPLOYMENT-PROFILE.md`. -3. Keep the deployment profile concise so it can be read early without wasting context. -4. Copy the suite with the filled-in deployment profile included. - -At runtime: - -1. The agent reads `AGENTS.md`. -2. The agent reads `DEPLOYMENT-PROFILE.md` if it is filled in. -3. The agent reads `SKILLS.md`. -4. The agent opens the relevant hub and specialized skill files only as needed. - -## Minimal Install - -If the target repository wants the smallest useful setup, copy: - -- `AGENTS.md` -- `DEPLOYMENT-PROFILE.md` -- `SKILLS.md` -- `hubs/` -- only the skill files the team expects to use often - -Good minimal baseline: - -- `skills/software/repo-exploration.md` -- `skills/software/feature-implementation.md` -- `skills/software/test-strategy.md` -- `skills/software/code-review.md` -- `skills/debugging/bug-triage.md` -- `skills/debugging/debugging-workflow.md` -- `skills/documentation/technical-docs.md` -- `skills/ui-ux/ux-review.md` - -## How To Customize Safely - -- Keep `AGENTS.md` short and stable; put detail in hubs and skill files. -- Add repo-specific instructions near the top of `AGENTS.md` or in existing repo instruction files. -- Treat `DEPLOYMENT-PROFILE.md` as the canonical place for staged build, tool, environment, and workflow defaults. -- Prefer editing hub routing before adding more root-level rules. -- Add new skill files only when they introduce a distinct workflow, risk area, or deliverable. -- If two skills overlap heavily, merge them or make the routing distinction explicit. - -## Context Limit Guidance - -- Do not instruct the agent to load the entire `skills/` tree on every task. -- Keep the default path to one hub plus two to four specialized skills. -- Reserve four to six skills for large cross-functional tasks. -- Use the routing examples to confirm the suite still routes clearly after customization. - -## Updating The Bundle - -- Pull improvements from this source repository into destination repos periodically. -- Refill the workbook and refresh the deployment profile when your preferred defaults change materially. -- Review local customizations before overwriting shared files. -- If a destination repo has stronger local conventions, keep those and treat this suite as the fallback layer. - -## Suggested Verification After Copying - -Check that the destination repo can answer these questions clearly: - -1. Where does the agent start? `AGENTS.md` -2. Where does the agent get preloaded defaults? `DEPLOYMENT-PROFILE.md` -3. Where does the agent look for available skills? `SKILLS.md` -4. How does the agent decide what to read next? Deployment profile, hubs, and routing examples -5. Does the repo still prioritize local instructions over the generic bundle? It should