v1.0.1 SKILL.md & MCP Standard PolyForm Shield 1.0.0

Turn rough problems into implementation-ready vertical slices.

An end-to-end, tool-agnostic AI agent skill set for Product Engineers. Move from ambiguous request to aligned scope and conflict-free execution in four progressive stages — without enterprise ceremony or AI slop.

QUICK INSTALL · SKILL.MD CLI
npx skills add mskasal/sculpting-framework
THE PRE-COMMIT BOTTLENECK

Coding agents write code fast. The hard part happens before commit #1.

01

Zero Meta-Jargon

Stakeholders never see internal labels like "Block gate" or "SSoT." Outgoing messages contain only crisp context, max 3 decision-changing questions, and realistic options.

02

Anti-Strawman Scope

Never invent fake third options just to fill a table. Separate Hard No-Go from Deferred explicitly, and close technical or vendor unknowns before sprint planning.

03

Built for Real Chaos

Tool-agnostic across Notion, Linear, Slack, GitHub, or plain manual handoffs — with explicit rules for delayed stakeholders, mid-flight pivots, 1-week P0 pauses, and owner handoffs.

FOUR PROGRESSIVE STAGES

Block → Rough Cut → Detail → Polish

Each stage ships as an independent SKILL.md orchestrated by sculpting after a one-time 4-question Context Layer setup (sculpting.context.md, kept local in open-source repos; manual mode stores project state in docs/sculpt-<slug>.md or in-thread).

01 sculpting-block

Block

Frame the problem with zero solution words, state cost of inaction, and gather missing critical unknowns via targeted async pings.

Outputs
Living State Card + 1-paragraph Block Brief + Template 1 drafts
Exit Gate
1-sentence solution-free problem, explicit "worth doing", unknowns closed or logged
02 sculpting-rough-cut

Rough Cut

Compare only viable options, cut excess scope ruthlessly, run Pre-Detail Spikes, clear Vendor/DPA gates, and lock unconditional sign-off.

Outputs
Rough Cut Pitch + Hard No-Go / Deferred + Templates 2, 3 & 5
Exit Gate
Single direction locked, zero open caveats/vetoes, spike recorded (when external/technical risk exists)
03 sculpting-detail

Detail

Ground contracts in the actual codebase, carry every spike edge case forward, and split work into conflict-free vertical slices.

Outputs
Evidence-based contracts + Template 4 Slices + 1-line capacity confirmations
Exit Gate
Independently testable slices, no double-booked owners, clear ACs & rollback (solo owners hand off as FYI)
04 sculpting-polish

Polish

Hand slices to coding/TDD/review skills, apply the No-Go scope brake during build, verify rollout & telemetry, and close the impact loop.

Outputs
Release Summary, AC verification log, stakeholder comms & impact note
Done Gate
ACs & reviews passed, telemetry flowing (when applicable, respecting privacy Red Lines), stakeholders notified
AUTOMATIC TRIAGE & FAST-TRACK

Zero bureaucracy on small tasks. Full rigor when stakes are high.

FAST-TRACK RULE

Micro-Feature / Tweak

Eligible when work is ≤2 days, 1 service, 1 owner, with no new vendor and no schema or architectural break.

  • Skipped completely: Living State Card, Block Brief / RFC, Sign-off table, State Machine, Spike Summary, Capacity Check.
  • 1-turn flow: Single async message (max 3 questions + 1-line No-Go) → thread approval → single Vertical Slice ticket → Polish.
  • Escalation valve: If discovery reveals cross-service dependencies, new vendor/GDPR impact, or >1 conflicting decision maker, exit Fast-Track and upgrade to Focused Feature.
INTERNAL TRIAGE MATRIX

Calibrated Depth by Work Type

Work Type Block Rough Cut Detail Polish
1. Micro-Feature Fast-Track Fast-Track 1 Ticket Primary
2. Focused Feature Medium Medium Crisp Standard
3. Cross-Cutting Deep Heaviest Detailed Coordinated
4. 0-to-1 Heaviest Aggressive cut Flexible Cyclical
5. Platform Bet Business case Risk & migration Sequenced Verify-heavy
MINIMAL RECOVERY PROTOCOL · 1 CARD + 2 RULES

Survive delayed stakeholders, mid-flight pivots, and 1-week P0 pauses.

Most frameworks break the moment real-world chaos hits. Sculpting adds only one pinned card and two rules to keep state recoverable without rewriting RFCs.

THE CARD

Living State Card

Pinned at the top of the project doc (max 10–15 lines): Active Direction & No-Go, Superseded Decisions, Provisional Assumptions, Active Owners/FTE & Sign-off, and Next Single Blocker.

Never copy-pasted into every chat reply — share only a link or a 1-line delta.

RULE 01 · DELAYS

Assumption + Expiry

When a decision maker is delayed, log one provisional assumption with an expiry date and owner. Proceed only on reversible (no-regret) work; freeze irreversible bets (infra, vendors, migrations).

Define expiry outcome upfront: assumption locks or triggers the 25-min fallback.

RULE 02 · PIVOTS & HANDOFFS

Delta & Sign-off Reset

On a scope pivot, 5+ business day pause, or owner handoff, never rewrite the RFC. Append a short Change Delta to the card and mark superseded calls.

Affected approvals and FTE commitments reset to Re-confirm — approvals never transfer across owners.

FIVE STANDARD MICRO-TEMPLATES

Short, decision-forcing formats. Nothing longer than a screen.

Full spec on GitHub ↗
STAGE 1 · BLOCK

Template 1: Async Discovery Ping

One short, separate message per stakeholder holding a missing critical unknown.

- 1 sentence of context (why I'm reaching out)
- Max 3 numbered questions — each stating WHICH DECISION the answer changes
- Expected response window

Rule: Zero framework jargon. Never auto-send without engineer review.
MEETING FALLBACK

Default to async. Trigger a 25-min Conflict Resolution Meeting only after 2 deadlocked async rounds or an expired Assumption Deadline — if unresolved at 25 min, the escalation owner makes one binding call (or the Hard Veto holds).

EMPIRICAL VALIDATION LOG

Stress-tested across 7 multi-agent swarm simulations.

Every rule in v1.0 exists because a realistic simulation broke without it — and was verified in a head-to-head A/B regression replay.

Read full validation log ↗
# Scenario Ver. Dimension Tested Outcome & Rules Earned
01 Unified Enterprise Billing (€180k ARR, EU VAT) v0.1 Cross-Cutting baseline Caught 5 structural bugs → Added Templates 1–4, Conditional Approval Lock, No-Go vs. Deferred, Pre-Detail Spike.
02 Enterprise SSO & Granular RBAC (12k SMB + SOC2) v0.2 Security vs. UX 5/5 passed. Added Vendor/DPA gate, Template 5 (Spike), Re-ping/Reset, Single-owner parallelism + capacity check.
03 EU Data Residency (GDPR) & AI v0.3 Convergence & ceremony 5/5 passed, 0 bugs. Completed in 12 messages, 0 meetings, 0 wasted stakeholder pings.
04 Usage-Based Pricing (Chaos Test 1/3) v0.3 Delays, pivots, P0 pause & handoff v0.3 broke under chaos → Added Minimal Recovery Protocol (Living State Card, Assumption + Expiry, Delta & Reset).
05 Public Shareable Links & SEO (Chaos Test 2/3) v0.4 2-round veto deadlock Meeting Fallback triggered cleanly → Added Timeout/Tie-Breaker and non-negotiable Hard Veto (Red Line) rules.
06 CSV Export & Date Filter (Chaos Test 3/3) v0.4 1-day micro-feature speed Caught Triage-vs-Contract contradiction → Added Fast-Track Rule (1 async turn, single ticket SSoT).
07 Unified Enterprise Billing (A/B Regression) v1.0-rc v0.1 vs. v1.0-rc replay 5/5 Sim 1 bugs eliminated, 8 msgs, 0 meetings, 0 regressions → Frozen as v1.0.

DEEP DIVE New to Sculpting? Read "How We Built Sculpting Framework" (4 min) →

INSTALLATION · OPEN SKILL.MD STANDARD

Install once. Run across your agent environment.

Works out of the box with Antigravity, Claude Code, Cursor, Codex, and any SKILL.md-compatible agent.

CLONE INTO ANTIGRAVITY PLUGINS DIRECTORY
git clone https://github.com/mskasal/sculpting-framework.git ~/.gemini/config/plugins/sculpting-framework

Antigravity automatically discovers plugin.json, assets/icon.png, and all 5 skills/*/SKILL.md files.

01

Prompt your agent

"Let's sculpt a new feature: enterprise customers need Net-30 invoicing with EU VAT reverse-charge."

02

4-question Context Layer (once)

On first run, sculpting records your architecture, owners/vetoes, tool adapters, and red lines in a local sculpting.context.md (and keeps manual-mode project docs in docs/sculpt-<slug>.md).

03

Triage & progressive gates

Small tasks take Fast-Track; larger bets move cleanly through Block → Rough Cut → Detail → Polish.