← ShipFrameCONTENT HISTORY

Update to ShipFrame

Snapshot Sep 30, 2026 · 23:14 UTC · version 0.4.2

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "Scan a new or unfamiliar repo and generate AGENTS.md with stack, commands, structure, and agent context.",
  "included_files": [],
  "name": "init-project",
  "skill_md_contents": "---\nname: init-project\ndescription: Scan a new or unfamiliar repo and generate AGENTS.md with stack, commands, structure, and agent context.\nallowed-tools: Glob Read Grep Write\neffort: medium\n---\n\n# init-project\n\nScan the current project and detect its full tech stack, then generate an `AGENTS.md` file with structured context so future Claude agents have everything they need to work effectively in this codebase.\n\n## Steps\n\n### 1. Scan for stack indicators\n\nSearch the project root and subdirectories for the following files and patterns. Use Glob and Read tools — do not guess.\n\n**Languages & runtimes**\n- `package.json` → Node.js / JavaScript / TypeScript\n- `tsconfig.json` → TypeScript\n- `requirements.txt`, `pyproject.toml`, `setup.py`, `Pipfile` → Python\n- `Cargo.toml` → Rust\n- `go.mod` → Go\n- `pom.xml`, `build.gradle`, `build.gradle.kts` → Java / Kotlin\n- `*.csproj`, `*.sln` → C# / .NET\n- `Gemfile` → Ruby\n- `composer.json` → PHP\n- `pubspec.yaml` → Dart / Flutter\n\n**Frameworks**\n- In `package.json` dependencies/devDependencies: look for `next`, `react`, `vue`, `svelte`, `angular`, `express`, `fastify`, `hono`, `remix`, `astro`, `nuxt`, `gatsby`\n- In Python files: look for `django`, `flask`, `fastapi`, `sqlalchemy`\n- In `Cargo.toml`: look for `axum`, `actix-web`, `rocket`\n- In `go.mod`: look for `gin`, `echo`, `fiber`\n\n**Databases & ORMs**\n- In dependency files: look for `prisma`, `drizzle-orm`, `typeorm`, `sequelize`, `mongoose`, `pg`, `mysql2`, `sqlite3`, `redis`, `supabase`, `@planetscale`, `@neon`\n- Config files: `prisma/schema.prisma`, `drizzle.config.*`\n\n**Styling**\n- `tailwind.config.*` → Tailwind CSS\n- In `package.json`: `styled-components`, `@emotion`, `sass`, `less`, `@mui`, `@chakra-ui`, `@radix-ui`, `shadcn`\n\n**Build tools & bundlers**\n- `vite.config.*` → Vite\n- `webpack.config.*` → Webpack\n- `turbo.json` → Turborepo\n- `nx.json` → Nx\n- `rollup.config.*` → Rollup\n- `.swcrc` → SWC\n\n**Testing**\n- In `package.json`: `jest`, `vitest`, `@testing-library`, `playwright`, `cypress`, `mocha`\n- `pytest.ini`, `conftest.py` → pytest\n- `jest.config.*`, `vitest.config.*`\n\n**Infrastructure & deployment**\n- `Dockerfile`, `docker-compose.*` → Docker\n- `.github/workflows/` → GitHub Actions\n- `vercel.json`, `.vercel/` → Vercel\n- `netlify.toml` → Netlify\n- `fly.toml` → Fly.io\n- `terraform/`, `*.tf` → Terraform\n- `kubernetes/`, `k8s/`, `*.yaml` with `kind: Deployment` → Kubernetes\n\n**Monorepo**\n- `pnpm-workspace.yaml` → pnpm workspaces\n- `turbo.json` → Turborepo\n- `nx.json` → Nx\n- `lerna.json` → Lerna\n- `packages/`, `apps/` directories → likely monorepo\n\n**Package manager**\n- `pnpm-lock.yaml` → pnpm\n- `yarn.lock` → Yarn\n- `bun.lockb` → Bun\n- `package-lock.json` → npm\n\n**Environment & config**\n- `.env`, `.env.example`, `.env.local` → environment variables (list keys only, never values)\n- `*.config.ts`, `*.config.js` at root\n\n### 2. Read key files in full\n\nAfter identifying which files exist, read:\n- `package.json` (full)\n- `tsconfig.json` (full)\n- `prisma/schema.prisma` or `drizzle.config.*` if present\n- `README.md` if present (first 80 lines)\n- `.env.example` if present (keys only)\n\n### 3. Infer project type\n\nBased on findings, classify the project as one or more of:\n- `web-app` (frontend UI)\n- `api` (backend/REST/GraphQL)\n- `fullstack` (frontend + backend in same repo)\n- `cli` (command-line tool)\n- `library` (npm/pip/cargo package)\n- `mobile` (React Native, Flutter, Expo)\n- `monorepo` (multiple apps/packages)\n- `infrastructure` (IaC, DevOps-only)\n\n### 4. Generate AGENTS.md\n\nWrite `AGENTS.md` at the project root with the following structure. Be specific — list actual package versions from dependency files, not guesses. If something is uncertain, omit it rather than guess.\n\n```markdown\n# Project Context\n\n## Project Type\n<!-- e.g., fullstack web-app, monorepo -->\n\n## Stack\n\n### Language & Runtime\n<!-- e.g., TypeScript 5.4, Node.js 20 -->\n\n### Framework\n<!-- e.g., Next.js 14 (App Router) -->\n\n### Styling\n<!-- e.g., Tailwind CSS 3.4, shadcn/ui -->\n\n### Database & ORM\n<!-- e.g., PostgreSQL via Prisma 5.x -->\n\n### Testing\n<!-- e.g., Vitest, Playwright for E2E -->\n\n### Build & Tooling\n<!-- e.g., Vite, Turborepo, pnpm workspaces -->\n\n### Deployment\n<!-- e.g., Vercel (frontend), Docker (API) -->\n\n## Project Structure\n<!-- Brief description of top-level directories and their purpose -->\n\n## Environment Variables\n<!-- List .env keys (no values) and what they're for if inferable -->\n\n## Development Commands\n<!-- Extract from package.json scripts or README -->\n```\n\n### 5. Confirm to the user\n\nAfter writing `AGENTS.md`, report:\n- What stack was detected\n- Where the file was written\n- Any ambiguities or gaps that could not be determined automatically\n"
}

SHA-256 of public snapshot: 951effbefec0f166a3193608d2647914420b26cf05fa5b2bc277f3769722f15d