# bigstack

Private Claude Code skills for Bigscreen development.

![Bigstack](title.png)  

- Setting up a development environment
- Building additional features on Bigscreen's software stack
- Adding new features on arda
- Adding new secure API endpoints
- Building internal factory software tools
- Testing and shipping updates
- (Future) Training models for machine learning inference

## Install

```bash
git clone <this-repo-url> ~/bigstack
cd ~/bigstack
bash setup.sh
```

The setup script will:
1. Install Node.js dependencies
2. Generate `SKILL.md` files from templates
3. Copy skills to `~/.claude/skills/`

## Skills

| Skill | Command | Description |
|-------|---------|-------------|
| bigstack-arda-feature | `/bigstack-arda-feature` | Design a new feature for the arda webapp |
| bigstack-cloud-setup | `/bigstack-cloud-setup` | Cloud repo dev environment setup and prerequisites |
| bigstack-browse | `/bigstack-browse` | Headless browser interaction and visual QA |
| bigstack-careful | `/bigstack-careful` | Destructive command guardrails via hooks |
| bigstack-codex | `/bigstack-codex` | OpenAI Codex second opinion (review/challenge/consult) |
| bigstack-cso | `/bigstack-cso` | Multi-phase security audit |
| bigstack-david-design-review | `/bigstack-david-design-review` | Live site visual design audit with fix loop |
| bigstack-docs | `/bigstack-docs` | Documentation generation for existing codebases |
| bigstack-upgrade | `/bigstack-upgrade` | Self-updater for bigstack |
| bigstack-plan-eng-review | `/bigstack-plan-eng-review` | Architecture and engineering plan review |
| bigstack-plan-design-review | `/bigstack-plan-design-review` | Multi-dimension design plan review |
| bigstack-qa | `/bigstack-qa` | Tiered QA testing (Quick/Standard/Exhaustive) |
| bigstack-retro | `/bigstack-retro` | Weekly retrospective from git history |
| bigstack-review | `/bigstack-review` | Pre-landing code review |
| bigstack-ship | `/bigstack-ship` | Automated shipping pipeline (test, review, PR) |
| bigstack-test | `/bigstack-test` | Test suite comprehension and extension |

## Rebuilding Skills

After editing any `SKILL.md.tmpl` file:

```bash
npm run gen:skill-docs    # regenerate SKILL.md files
bash setup.sh             # reinstall to ~/.claude/skills/
```

To check if generated files are up to date without modifying them:

```bash
npm run gen:skill-docs:dry-run
```

## Adding a New Skill

1. Create a directory: `mkdir bigstack-my-skill`
2. Create `bigstack-my-skill/SKILL.md.tmpl` with frontmatter and workflow
3. Use `{{PLACEHOLDER}}` markers for shared content (see `scripts/resolvers/`)
4. Run `bash setup.sh` to generate and install

## Relationship to gstack

bigstack is structurally inspired by [gstack](https://github.com/garrytan/gstack) but is an independent, private repository. It borrows the template system pattern and some skill concepts, adapted for working on existing codebases rather than greenfield projects.