Skip to content
Skills Library
AI & agents · Tool integration

bootstrap

/bootstrap

This skill should be used when the user says "bootstrap", "set up Jerry", "configure guardrails", "initialize Jerry", or asks how to get started with Jerry. Sets up Jerry's context distribution by syncing behavioral rules and patterns.

Repository
jerry ↗
Licence
Apache-2.0
Last repository change
26.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 26.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

This skill should be used when the user says "bootstrap", "set up Jerry", "configure guardrails", "initialize Jerry", or asks how to get started with Jerry. Sets up Jerry's context distribution by syncing behavioral rules and patterns.

Triggers from the description

bootstrapset up Jerryconfigure guardrailsinitialize Jerry
Original author description

This skill should be used when the user says "bootstrap", "set up Jerry", "configure guardrails", "initialize Jerry", or asks how to get started with Jerry. Sets up Jerry's context distribution by syncing behavioral rules and patterns.

How it works

  1. Document Sections
  2. Document Audience (Triple-Lens)
  3. Purpose
  4. When to Use This Skill
  5. What This Does
  6. Quick Start
  7. How It Works
  8. Options
  9. Troubleshooting
  10. For Contributors
Original SKILL.md headings · 229 lines, 1,261 words
SKILL.md preview
---
name: bootstrap
description: This skill should be used when the user says "bootstrap", "set up Jerry", "configure guardrails", "initialize Jerry", or asks how to get started with Jerry. Sets up Jerry's context distribution by syncing behavioral rules and patterns.
version: 1.0.0
allowed-tools:
  - Read
  - Write
  - Bash
activation-keywords:
  - "bootstrap"
  - "set up Jerry"
  - "configure guardrails"
  - "initialize Jerry"
  - "context distribution"
  - "sync rules"
  - "get started"
---

# Bootstrap Skill

> **Version:** 1.0.0
> **Framework:** Jerry Bootstrap
> **Constitutional Compliance:** Jerry Constitution v1.0

Let's get your bindings adjusted so you don't have any Jerry moments.

---

## Document Sections

| Section | Purpose |
|---------|---------|
| [Purpose](#purpose) | What this skill does |
| [When to Use This Skill](#when-to-use-this-skill) | Activation triggers |
| [What This Does](#what-this-does) | How context distribution works |
| [Quick Start](#quick-start) | Getting started commands |
| [How It Works](#how-it-works) | Architecture of the sync mechanism |
| [Options](#options) | CLI flags and arguments |
| [Troubleshooting](#troubleshooting) | Common issues and solutions |
| [For Contributors](#for-contributors) | Adding new rules and patterns |
| [Available Agents](#available-agents) | Agent registry for this skill |
| [Constitutional Compliance](#constitutional-compliance) | Principle mapping |
| [Integration with Other Skills](#integration-with-other-skills) | Cross-skill dependencies |
| [Templates](#templates) | Template usage |
| [Routing Disambiguation](#routing-disambiguation) | When this skill is the wrong choice |
| [References](#references) | Canonical sources |

---

## Document Audience (Triple-Lens)

This SKILL.md serves multiple audiences:

| Level | Audience | Sections to Focus On |
|-------|----------|---------------------|
| **L0 (ELI5)** | New users, contributors | [What This Does](#what-this-does), [Quick Start](#quick-start), [How It Works](#how-it-works) |
| **L1 (Engineer)** | Developers setting up Jerry | [Quick Start](#quick-start), [Options](#options), [Troubleshooting](#troubleshooting) |
| **L2 (Architect)** | Framework maintainers | [How It Works](#how-it-works), [For Contributors](#for-contributors), [Constitutional Compliance](#constitutional-compliance) |

---

## Purpose

The Bootstrap skill sets up Jerry's context distribution system by synchronizing behavioral rules and patterns from the canonical source (`.context/`) to Claude Code's read location (`.claude/`). This ensures that Claude Code always has access to the latest framework rules.

### Key Capabilities

- **Platform-Aware Linking** - Uses the best available strategy per platform (symlinks, junction points, or file copy)
- **Drift Detection** - Identifies when copied files are out of sync with the source
- **Idempotent Setup** - Safe to run multiple times; won't overwrite unless `--force` is used
- **Validation Mode** - Check existing setup without making changes (`--check`)

---

## When to Use This Skill

Activate when:

- First time setting up the Jerry repository
- After pulling updates that modify `.context/rules/` or `.context/patterns/`
- Troubleshooting Claude Code not seeing the latest rules
- Migrating Jerry to a new machine
- Verifying that context distribution is working correctly

---

## What This Does

Jerry's behavioral rules and patterns live in `.context/` (the canonical source). Claude Code reads them from `.claude/rules/` and `.claude/patterns/`. This skill syncs the two using platform-aware linking:

- **macOS/Linux**: Symlinks (instant, auto-propagating)
- **Windows with Developer Mode**: Symlinks
- **Windows without Developer Mode**: Junction points (no admin required)
- **Fallback**: File copy with drift detection

**Note on Guides:** The `.context/guides/` directory is intentionally NOT synced. Jerry uses a three-tier architecture where rules and patterns are auto-loaded at session start, but guides remain on-demand content. This prevents context bloat while keeping detailed guidance available when explicitly needed.

---

## Quick Start

Run the bootstrap script to set up context distribution:

```bash
# Full setup
uv run python scripts/bootstrap_context.py

# Check if you're already set up
uv run python scripts/bootstrap_context.py --check

# Force re-sync (overwrites existing)
uv run python scripts/bootstrap_context.py --force
```

---

## How It Works

```
.context/                          .claude/
├── rules/  ──── symlink ────►    ├── rules/
├── patterns/ ── symlink ────►    ├── patterns/
└── templates/                     ├── agents/    (stays)
                                   ├── commands/  (stays)
                                   └── settings.json (stays)
```

The script (`scripts/bootstrap_context.py`) handles:

1. **Platform detection** - Picks the right linking strategy
2. **Existing setup check** - Won't overwrite unless `--force`
3. **Fallback chain** - Symlink -> junction point -> file copy
4. **Drift detection** - `--check` verifies sync integrity

---

## Options

| Flag | What It Does |
|------|-------------|
| (none) | Full bootstrap with friendly output |
| `--check` | Verify existing setup without changes |
| `--force` | Overwrite existing links/copies |
| `--quiet` | Minimal output (for CI/scripts) |

---

## Troubleshooting

**"Source not found"** - You're not in the Jerry repo root, or `.context/` is missing. Make sure you cloned the full repo.

**"Already linked"** - You're good! Run `--check` to verify, or `--force` to re-link.

**Windows junction point fails** - Try running from an elevated prompt, or ensure you're on the same drive as the repo.

**Drift detected** - Files in `.claude/rules/` don't match `.context/rules/`. This happens with file-copy setups. Run without `--check` to re-sync.

---

## For Contributors

If you add new rules to `.context/rules/` or patterns to `.context/patterns/`, they'll automatically appear in `.claude/` for anyone using symlinks/junctions. File-copy users need to re-run bootstrap.

### Adding New Rules

1. Create the rule file in `.context/rules/{rule-name}.md`
2. Follow the markdown navigation standards (H-23/H-24) - include navigation table
3. Use tier vocabulary (HARD/MEDIUM/SOFT) per `quality-enforcement.md`
4. Add an L2-REINJECT comment if the rule is critical
5. Test that symlink users see the new rule immediately
6. Document in release notes that file-copy users should re-bootstrap

---

## Available Agents

This skill does not use agent-based workflows. It provides a single bootstrap script that handles all setup operations.

**Invocation:** Run the bootstrap script directly via `uv run python scripts/bootstrap_context.py`

---

## Constitutional Compliance

The Bootstrap skill adheres to the **Jerry Constitution v1.0**:

| Principle | Requirement | Implementation |
|-----------|-------------|----------------|
| P-002: File Persistence | State persisted to filesystem | Symlinks/junctions or file copies created on disk |
| P-022: No Deception | Transparent about actions | Script reports exactly what it does (link/copy/skip) |
| H-05: UV Only | Use uv for Python execution | Script invoked via `uv run python` |

**Self-Critique Checklist (Before Response):**
- [ ] P-002: Are symlinks/copies persisted to disk?
- [ ] P-022: Does script output clearly state what happened?
- [ ] H-05: Did we use `uv run` instead of `python` directly?

---

## Integration with Other Skills

The bootstrap skill is foundational and does not integrate with other skills. However, it enables all other skills by ensuring that:

- `.context/rules/quality-enforcement.md` is accessible for adversarial quality mode
- `.context/rules/architecture-standards.md` is accessible for hexagonal architecture validation
- `.context/rules/coding-standards.md` is accessible for type hints and docstring enforcement
- `.context/patterns/` is accessible for CQRS, event sourcing, and other patterns

---

## Templates

The bootstrap skill does not use templates. It operates directly on the `.context/` directory structure.

---

## Routing Disambiguation

> When this skill is the wrong choice and what happens if misrouted.

| Condition | Use Instead | Consequence of Misrouting |
|-----------|-------------|--------------------------|
| Task requires research, analysis, or root cause investigation | `/problem-solving` | Bootstrap is a navigation/setup tool; invoking it for analytical tasks wastes context budget loading orientation content with no analytical capability |
| Task requires code generation or implementation | `/problem-solving` (ps-reviewer) or direct coding | Bootstrap agents have no code generation methodology; context loaded with sync/linking logic irrelevant to implementation |
| Task requires architectural design or ADR creation | `/architecture` or `/problem-solving` (ps-architect) | Bootstrap provides no design decision framework; architectural context entirely absent |
| Task requires quality review or adversarial critique | `/adversary` | Bootstrap has no quality scoring or adversarial strategy capability |
| Task requires multi-agent workflow coordination | `/orchestration` | Bootstrap has no orchestration, state tracking, or checkpoint capability |
| Task requires security assessment or threat modeling | `/eng-team` or `/red-team` | Bootstrap has no security methodology; 10+ security agents remain uninvoked |

---

## References

- Bootstrap script: `scripts/bootstrap_context.py`
- Source directory: `.context/rules/`, `.context/patterns/`
- Target directory: `.claude/rules/`, `.claude/patterns/`
- Jerry Constitution: `docs/governance/JERRY_CONSTITUTION.md`
- Platform-specific linking: Windows junction points, Unix/macOS symlinks

---

*Skill Version: 1.0.0*
*Constitutional Compliance: Jerry Constitution v1.0*
*Created: 2026-02-12*
*Last Updated: 2026-02-16*

Versions

RepositoryScoreLicence
This page · geekatron/jerry100Apache-2.0
renzrollon/interlock100MIT
vercel-labs/vercel-plugin100Apache-2.0
bytedance/deer-flow100MIT
Nazhra05/Super-set100MIT
Nazhra05/Super-set100MIT
chaordic-io/discipline100MIT
fullymiddleaged/clawness100MIT
vercel/vercel-plugin100Apache-2.0

Database snapshot: 13.11.2026 · package version a62ba47a6857 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100prompt-engineering
    Structured prompt construction and quality validation for Jerry Framework. Invoke when building structured prompts, generating NPT-009/NPT-013 constraints, or scoring prompt quality. Guides users through the 5-element prompt anatomy, generates formatted constraints with XML…
  • 100writing-rules
    Creates behavioral rules in markdown to block dangerous commands or restrict AI behavior. Use when adding safety guardrails or preventing specific commands.
  • 90agent-context-bootstrap
    Bootstrap repo-local agent context for Codex and other coding agents. Use when setting up AGENTS.md, docs/agents, issue tracker rules, triage labels, domain docs, ADR locations, validation commands, or skill usage instructions for a repository.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.