Setup

If ~/agentic-coding/ does not exist or is empty, read setup.md, ask a concise kickoff question, and keep any persistence explicitly opt-in.

Positioning

This skill is intentionally different from agentic-engineering and vibe-coding:

• agentic-engineering focuses on multi-agent operating patterns and team throughput.
• vibe-coding focuses on prompt-led exploration and fast idea shipping.
• agentic-coding focuses on contract-first implementation, proof of fix, and reviewer-ready handoff.

When to Use

User needs merge-ready code from an AI agent with explicit quality gates. Use for production features, risky refactors, bug fixes with reproducible failures, and Xcode-centered work such as Swift feature delivery, iOS/macOS regressions, and release-branch hotfixes.

Architecture

Memory lives in ~/agentic-coding/. See memory-template.md for setup.

~/agentic-coding/
|- memory.md       # Persistent preferences and operating mode
|- contracts.md    # Accepted task contracts and non-goals
|- evidence.md     # Test evidence and verification snapshots
`- handoffs.md     # Delivery notes and rollback hints

Quick Reference

Load these files on demand to keep context focused and execution fast.

Core Rules

1. Lock a Contract Before Writing Code

Start every task with a compact contract:

• Objective: exact outcome in one sentence
• Acceptance: checks that prove success
• Non-goals: what must stay untouched
• Constraints: stack, style, limits, deadlines

No contract, no code.

2. Run the PACT Loop

Use the same execution loop every time:

1. Problem framing: restate objective and assumptions
2. Acceptance design: define checks before edits
3. Change set: produce the smallest useful diff
4. Trace and test: show evidence and residual risk

This skill is execution discipline, not brainstorming. For Xcode workflows, tie acceptance to a concrete target, simulator/device, and test command before editing.

3. Keep Diffs Surgical

One user objective maps to one focused change set:

• Prefer file-local edits over broad rewrites
• Separate behavior change from style cleanup
• Avoid hidden side effects outside declared scope

If scope grows, split into a second contract.

4. Prove Failure Then Prove Fix

For bugs and regressions:

• Capture the failing condition first (test, log, or reproduction)
• Apply minimal fix
• Re-run the same check to prove resolution

Never claim fixed without before and after evidence.

5. Deliver Handoff-Grade Output

End each cycle with a delivery packet:

• What changed and why
• Files touched and blast radius
• Validation run and results
• Known risks and rollback path

If handoff is unclear, the task is not finished.

6. Escalate With a Structured Fallback

When blocked after two failed attempts:

• Stop editing
• State what was tried
• Propose two grounded alternatives
• Request a decision with tradeoffs

Do not keep guessing in loops.

Common Traps

• Starting implementation without acceptance checks -> endless iteration and unclear done state.
• Asking the agent for full rewrites -> noisy diffs and avoidable regressions.
• Mixing feature work with architecture overhaul -> weak reviewability and hard rollback.
• Reporting success without reproducible evidence -> false confidence in production.
• Treating AI output as final draft -> quality debt moved to code review.

Security & Privacy

Data that leaves your machine:

• None from this skill itself

Data that stays local:

• Contracts, evidence notes, and handoff summaries in ~/agentic-coding/

This skill does NOT:

• Trigger undeclared network requests
• Access files outside its own memory path
• Write to global or platform memory stores
• Auto-approve risky code without explicit evidence

Scope

This skill ONLY:

• Improves execution quality of AI-assisted coding
• Enforces contract driven implementation and verification
• Produces clear handoff packets for reviewers

This skill NEVER:

• Replaces security review for high risk domains
• Encourages blind trust in generated code
• Overrides project specific contribution rules

Related Skills

Install with clawhub install <slug> if user confirms:

• agentic-engineering - Multi-agent collaboration and operating patterns.
• coding - General coding support across stacks and tasks.
• code - Broad code authoring and editing assistance.
• copilot - Companion style IDE assistance patterns.
• delegate - Structured task delegation to autonomous agents.

Feedback

• If useful: clawhub star agentic-coding
• Stay updated: clawhub sync