blueprint-promote
Move generated artifact to custom layer to preserve manual edits. Use when promoting a generated rule, preserving .claude/rules/ changes, or stopping sync warnings.
What this skill does
Copy a generated rule to the custom rules layer for preservation.
## When to Use This Skill
| Use this skill when... | Use blueprint-sync instead when... |
|---|---|
| You want to preserve manual edits to a single generated rule | You want to scan all generated content for drift first |
| You want to stop sync warnings on a modified auto-generated file | You want regenerate/keep options across many files at once |
| You say "promote from proposed to custom" or "acknowledge modifications" | Use blueprint-generate-rules instead to regenerate from PRDs |
## Steps
**Purpose**:
- Copy generated content from `.claude/rules/` to preserve modifications
- Mark as acknowledged in manifest to prevent overwrite warnings
- Generated rules in `.claude/rules/` are the standard location (v3.0)
**Usage**: `/blueprint:promote [name]`
**Examples**:
- `/blueprint:promote testing-strategies` - Acknowledge a rule's modifications
1. **Parse argument**:
- Extract `name` from arguments
- If no name provided, list available generated rules and ask user to choose
2. **Locate the rule**:
```bash
# Check if it's a generated rule
test -f .claude/rules/{name}.md
```
If not found:
```
Rule '{name}' not found in generated content.
Available rules:
- architecture-patterns
- testing-strategies
- implementation-guides
- quality-standards
```
3. **Check if already acknowledged**:
- Read manifest for `custom_overrides.rules`
- If already in list, report "Already acknowledged"
4. **Confirm acknowledgment**:
```
question: "Acknowledge modifications to {name}?"
description: |
This will:
1. Mark {name} as user-modified in manifest
2. Prevent overwrite warnings during sync
3. Keep the rule in .claude/rules/
options:
- label: "Yes, acknowledge"
description: "Mark as user-modified and preserve changes"
- label: "No, keep as generated"
description: "Leave as regeneratable (may show warnings)"
```
5. **Update manifest**:
- Add to `custom_overrides.rules`
- Update `updated_at` timestamp
Example manifest update:
```json
{
"generated": {
"rules": {
// testing-strategies still listed
}
},
"custom_overrides": {
"rules": ["testing-strategies"] // added
}
}
```
6. **Report**:
```
Rule modifications acknowledged!
testing-strategies.md:
- Location: .claude/rules/testing-strategies.md
- Status: User-modified (acknowledged)
This rule will now:
- Not show modification warnings in /blueprint:sync
- Still be tracked in manifest
- Be your responsibility to maintain
To edit: .claude/rules/testing-strategies.md
```
**Architecture note (v3.0)**:
Generated content now goes directly to `.claude/rules/` instead of a separate generated layer.
The manifest tracks which rules are user-modified vs auto-generated.
**Tips**:
- Acknowledge rules you want to customize
- Unacknowledged modified rules will show warnings in /blueprint:sync
- You can regenerate by removing from custom_overrides and running `/blueprint:generate-rules`
Related in General
modeling-omnistudio-epc-catalog
IncludedSalesforce Industries CME EPC product-modeling skill for Product2-based catalog creation. Use when creating EPC products, configuring product attributes, building offer bundles with Product Child Items, or reviewing EPC DataPack JSON metadata for product catalog changes. TRIGGER when: user creates or updates Product2 EPC records, AttributeAssignment payloads, AttributeMetadata/AttributeDefaultValues, Offer bundles, or ProductChildItem relationships. DO NOT TRIGGER when: designing OmniScripts/FlexCards/Integration Procedures (use building-omnistudio-omniscript, building-omnistudio-flexcard, or building-omnistudio-integration-procedure), implementing Apex business logic (use generating-apex), or troubleshooting deployment pipelines (use deploying-metadata).
relationship-science-coach
IncludedUse this skill for direct, practical adult relationship coaching: couples conflict, repair, trust, marriage, dating, flirting, attachment patterns, emotional connection, sex, desire differences, eroticism, kink negotiation, affection, love languages, breakups, and long-term passion. Draw on Gottman, EFT and Hold Me Tight, attachment science, modern sex research, Perel, Nagoski, Kerner, Schnarch, Love and Stosny, and flexible love-language tools. Be concrete and low-hedge. Redirect only for imminent danger, abuse, coercive control, minors, non-consent, self-harm, stalking, or medical/legal/psychiatric decisions.
building-sf-integrations
IncludedSalesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture. TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files. DO NOT TRIGGER when: Connected App/OAuth config (use configuring-connected-apps), Apex-only logic (use generating-apex), or data import/export (use handling-sf-data).
venue-templates
IncludedAccess comprehensive LaTeX templates, formatting requirements, and submission guidelines for major scientific publication venues (Nature, Science, PLOS, IEEE, ACM), academic conferences (NeurIPS, ICML, CVPR, CHI), research posters, and grant proposals (NSF, NIH, DOE, DARPA). This skill should be used when preparing manuscripts for journal submission, conference papers, research posters, or grant proposals and need venue-specific formatting requirements and templates.
let-fate-decide
IncludedDraws the 12 Houses of the Zodiac Tarot spread to inject entropy into planning when prompts are vague, ambiguous, or casually delegated. Interprets the spread to guide next steps. Use when the user says 'let fate decide', 'YOLO', 'whatever', 'idk', or other nonchalant phrases, makes Yu-Gi-Oh references, or when you are about to arbitrarily pick between multiple reasonable approaches. Prefer over ask-questions-if-underspecified when the user's tone is casual or playful rather than precision-seeking.
net-ops
IncludedCross-platform network troubleshooting (Windows, macOS, Linux) via local or remote shell. Use for: DNS broken, can't resolve hostnames, nslookup/dig works but apps fail, NRPT, WFP, scutil, /etc/resolver, systemd-resolved, /etc/resolv.conf, NetworkManager, VPN DNS leak residue (ProtonVPN/Mullvad/WireGuard/AnyConnect), AV/firewall blocking DNS or DoH, Tailscale DNS interaction, intermittent connectivity, remote diagnostics over SSH.