Foundary by StackSmart

UI kits · AI agents · workflows — from idea to solid product base, faster.

npx @bystacksmart/foundary@latest

What's included

20 AI Agents — invoke with /agent-name in your editor

| Agent | Role | |---|---| | /core_setup | Project Setup — configure a project from scratch | | /core_team | Team Orchestrator — dispatch work to the right agents | | /core_architect | Solution Architect — system design and technical decisions | | /core_fullstack | Fullstack Developer — end-to-end feature implementation | | /core_backend | Backend Developer — APIs, databases, server-side logic | | /core_designer | UX/UI Designer — wireframes, components, design systems | | /core_qa | QA Engineer — testing strategy, coverage, bug reports | | /core_devops | DevOps Engineer — CI/CD, infra, deployment | | /core_cybersec | Cybersecurity Analyst — security review and hardening | | /core_marketer | Growth Marketer — copy, campaigns, acquisition | | /core_pm | Project Manager — planning, priorities, roadmap | | /core_audit-ux | UX Audit — comprehensive design guidelines review | | /core_debug-module | Debug Module — systematic bug investigation | | /core_new-module | New Module — orchestrate adding a new feature | | /core_cost-estimate | Cost Estimate — estimate dev cost from codebase | | /core_generate-stubs | Generate Stubs — realistic placeholder data and mocks | | /core_git-push | Git Push — safe push pipeline with checks | | /core_update-docs | Update Docs — keep documentation in sync with code | | /content_audit-article | Article Audit — SEO / emotion / conversion review | | /content_blog-strategy | Blog Strategy — SEO content engine |

7 Design Systems — CSS tokens + component library + AI-ready docs

Beacon · Clover · Cobalt · Sable · ShipSmart · Slate · Volt

Each design system includes:

• CSS custom properties (tokens)
• Component class library
• Full documentation formatted for AI agents

How it works

# 1. Run in your project folder
npx @bystacksmart/foundary@latest

# 2. Enter your licence key (from purchase email)
# 3. Choose your editor — agents are placed in the right location
# 4. Start working — run /core_setup to get started

Content is cached on your machine after the first download. Every subsequent project setup is instant — no re-download, no re-validation.

Commands

foundary                  # Smart entry: status if installed, install if not
foundary install          # Guided install
foundary update           # Pull latest agents and design systems
foundary status           # Show licence, cache version, configured editor
foundary list             # Browse available agents and design systems
foundary add <name>       # Copy a design system into the current project
foundary reset            # Clear saved licence key
foundary help             # Show all commands

Supported editors

Tier 1 — Full slash command support (/agent-name)

| Editor | Agents location | Scope | |---|---|---| | Claude Code | ~/.claude/commands/ | Global — every project | | Cursor | .cursor/agents/ | Per-project | | Cline | ~/.cline/rules/ | Global — every project | | Continue.dev | ~/.continue/rules/ | Global — every project | | Windsurf | .windsurf/rules/ | Per-project | | Google Antigravity | ~/.gemini/antigravity/global_workflows/ | Global — every project |

Tier 2 — Static context (agents merged into a single file)

| Editor | File | Note | |---|---|---| | GitHub Copilot | .github/copilot-instructions.md | Per-project | | Gemini | .gemini/styleguide.md | Per-project | | Zed | AGENTS.md | Per-project | | Amazon Q | .amazonq/rules/ | Per-project | | Other | AGENTS.md | Per-project |

Tier 2 editors don't support native slash commands. Agents are merged into a single file with an index — copy the section you need and paste it as a system prompt.

Design systems in your project

After install, design systems land in .foundary/design-systems/. Add more at any time:

foundary add Beacon     # copy Beacon into the current project
foundary add Volt       # copy Volt into the current project
foundary list           # see all available design systems

All agents know to look in .foundary/design-systems/ automatically. Each design system has its own CLAUDE.md with tokens, components, and usage rules.

Requirements

• Node.js 18+
• A valid Foundary licence → store.fredthedev.com/foundary

One licence = up to 3 machines.

Troubleshooting

"No content downloaded yet" Run foundary install from inside a project folder (not from ~).

Licence re-asked every run Your machine ID was not persisted. Run foundary install once — it will save your key and machine ID permanently.

Agents not showing up in editor Run foundary status to check which editor was configured, then re-run foundary install if needed.

License

Proprietary — see LICENSE file.