# Scaffold

Use when starting hyperflow in a new project, refreshing the .hyperflow/ cache, or...

- Repository: https://github.com/jeremylongshore/tons-of-skills-marketplace (2890 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add jeremylongshore/tons-of-skills-marketplace --skill scaffold -g -a claude-code -y`
Codex: `npx skills add jeremylongshore/tons-of-skills-marketplace --skill scaffold -g -a codex -y`
Cursor: `npx skills add jeremylongshore/tons-of-skills-marketplace --skill scaffold -g -a cursor -y`
Gemini CLI: `npx skills add jeremylongshore/tons-of-skills-marketplace --skill scaffold -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add jeremylongshore/tons-of-skills-marketplace`

## Description

Use when starting hyperflow in a new project, refreshing the .hyperflow/ cache, or installing auto-detection shims (AGENTS.md, CLAUDE.md). One-shot project setup; does not start the spec → scope → dispatch chain. Trigger with /hyperflow:scaffold, "init hyperflow", "set up hyperflow", "refresh hyperflow", "install hyperflow shims".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Scaffold

One-shot project setup. Analyzes the codebase, builds the `.hyperflow/` cache, seeds the memory skeleton, and optionally installs detection shims for other AI tools. Does not start the plan → dispatch chain, invoke `/hyperflow:plan` when you're ready for that.

## Step 1, Analysis Cache

Check for `.hyperflow/` at project root.

**If absent, dispatch parallel searchers (single message, six Agent calls):**

| Label | File generated | Discovers |
|---|---|---|
| `Searcher, analyzing tech stack` | `profile.md` | Name, language, framework, build commands |
| `Searcher, mapping folder structure` | `architecture.md` | Dirs, patterns, routing, data flow |
| `Searcher, extracting conventions` | `conventions.md` | Naming, style, linting rules |
| `Searcher, scanning dependencies` | `dependencies.md` | UI lib, state, data fetching, DB, auth |
| `Searcher, auditing test setup` | `testing.md` | Runner, E2E, patterns, commands |
| `Searcher, reading git workflow` | `git-workflow.md` | Branches, commits, CI/CD, PR conventions |

See [project-analysis.md](references/project-analysis.md) for what each file captures.

**If present, staleness check:**
Compute SHA256 of tracked config files, compare against `.hyperflow/.checksums`. Refresh only stale files. Print `Refreshing, <comma-separated list of stale files>`.

**After analysis:**
- Write `.hyperflow/.checksums` (SHA256 of `package.json`, `tsconfig.json`, eslint/biome config, etc.)
- Write `.hyperflow/.version` (the current plugin version from `skills/hyperflow/VERSION`) so the cache is stamped current. The session-start migrator (`scripts/migrate-cache.py`) reads this marker on later sessions and brings an older cache forward when the plugin version moves, a missing/older marker triggers an idempotent, additive migration (new memory files, refreshed doctrine copy).
- Append to `.gitignore` if `.hyperflow/` is not already excluded

## Step 2, Memory Skeleton

Create `.hyperflow/memory/` if absent:

The rest: https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/ai-agency/hyperflow/skills/scaffold/SKILL.md