Skip to content
cccskills
FreePublished on GitHub

role-developer

Developer role in AID methodology. Use for implementation, debugging, technical design, TDD workflow, code review.

The English summary is being prepared. Showing the original description.

See how to install

Files included (8)

  • SKILL.md2.5 KB
  • references/condition-based-waiting.ts7.5 KB
  • references/debugging-checklist.md3.6 KB
  • references/defense-in-depth.ts8.8 KB
  • references/root-cause-tracing.md6.5 KB
  • scripts/check-file-size.sh6.8 KB
  • scripts/find-polluter.sh3.9 KB
  • SKILL.extended.md4.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Developer Role

Core Responsibilities

  • Translate requirements to technical designs
  • Write clean, tested, maintainable code
  • Debug systematically - never guess
  • Identify risks and edge cases early

Phase Focus

PhaseFocusOutput
DiscoveryFeasibilityRisk notes, complexity
PRDRequirements clarityQuestions, edge cases
Tech SpecArchitectureSpec, APIs, data models
DevelopmentImplementationCode, tests, docs
QA & ShipBug fixesFixes, deployment docs

TDD Workflow

RED (Write failing test) -> GREEN (Minimal code) -> REFACTOR (Clean up) -> REPEAT

Systematic Debugging

NO FIXES WITHOUT ROOT CAUSE.

  1. Root Cause - Read errors, reproduce, gather evidence
  2. Pattern Analysis - Find working examples, compare
  3. Hypothesis - Single theory, test minimally
  4. Implementation - Failing test, single fix, verify

If 3+ fixes failed -> Stop, question architecture.

Defense-in-Depth

Validate at EVERY layer:

LayerPurpose
Entry PointReject invalid at boundary
Business LogicValidate for operation
Environment GuardsBlock dangerous ops
Debug InstrumentationLog for forensics

300-Line Rule

SizeAction
< 200Ideal
200-300Consider splitting
300-400Split now
> 400Must refactor

Module Structure

feature/
  feature.controller.ts   # HTTP (thin)
  feature.service.ts      # Business logic
  feature.repository.ts   # Data access
  feature.types.ts        # Types
  feature.validation.ts   # Validation

Code Quality

Must have: single responsibility, DRY code, type hints, meaningful names, error handling, files < 300 lines.

Must not have: any types, TODO/FIXME, commented-out code, silent exceptions, business logic in controllers, arbitrary timeouts in tests.

Async Testing

// Wrong
await sleep(100);

// Right
await waitFor(() => result !== undefined);

Anti-Patterns

Anti-PatternFix
No TDDTests first
if is_test in prodNo test logic
Happy path onlyTest errors
Over-mockingReal dependencies
Guessing at fixesSystematic debug
Large filesSplit modules

Handoff Checklist

  • All tests passing
  • Code reviewed
  • Error handling implemented
  • Edge cases covered
  • Files < 400 lines
  • Multi-layer validation

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

AID Phase 4 - Development phase. Use for implementing features, TDD practices, code reviews, transitioning from planning to QA.

The English summary is being prepared. Showing the original description.

ilandahan/AID10Updated Sep 23, 2026

AID Phase 0 - Research & discovery. Use for validating problem spaces, identifying stakeholders, defining success metrics, deciding whether to proceed.

The English summary is being prepared. Showing the original description.

ilandahan/AID10Updated Sep 23, 2026

AID Phase 3 - Implementation Planning with consolidation-first approach. Resolves contradictions between PRD and Tech Spec, creates consolidated master document, then breaks down into actionable tasks and populates Jira. Includes sprint planning and risk assessment.

The English summary is being prepared. Showing the original description.

ilandahan/AID10Updated Sep 23, 2026

AID Phase 1 - PRD creation. Use for user stories, acceptance criteria, scoping features, transitioning from discovery to tech spec.

The English summary is being prepared. Showing the original description.

ilandahan/AID10Updated Sep 23, 2026

AID Phase 5 - QA and Release. Use for validating implementations, acceptance tests, preparing releases, deployment, operational readiness.

The English summary is being prepared. Showing the original description.

ilandahan/AID10Updated Sep 23, 2026

AID Phase 2 - Technical Specification. Use for system architecture, API contracts, data models, security architecture, transitioning from PRD to implementation.

The English summary is being prepared. Showing the original description.

ilandahan/AID10Updated Sep 23, 2026

See all skills by ilandahan

Report a problem with this skill