reez455g/kerangka/agent-skills

Agent Skills: Production-Grade Engineering

Overview

Agent Skills is a collection of production-grade engineering workflows designed to ensure AI agents produce high-quality, reliable, and secure code. These workflows enforce the discipline and best practices used by senior engineers.

Skill Discovery

When a task arrives, identify the relevant development phase and refer to the corresponding reference file for detailed procedural guidance:

1. Define & Plan

• Clarify intent: Use interview-me.md to surface what the user actually wants.
• Refine ideas: Use idea-refine.md for structured thinking about a concept.
• Write specs: Use spec-driven-development.md to define requirements before code.
• Break down tasks: Use planning-and-task-breakdown.md to decompose work into verifiable chunks.

2. Build & Implement

• Core implementation: Use incremental-implementation.md for vertical feature slices.
• UI engineering: Use frontend-ui-engineering.md for accessible, polished interfaces.
• API design: Use api-and-interface-design.md for stable, clear contracts.
• Context management: Use context-engineering.md to manage the agent's context window.
• Doc-driven code: Use source-driven-development.md to verify against official documentation.
• Adversarial review: Use doubt-driven-development.md for cross-examining non-trivial decisions.

3. Verify & Debug

• TDD: Use test-driven-development.md for a test-first approach.
• Browser testing: Use browser-testing-with-devtools.md for runtime verification.
• Debugging: Use debugging-and-error-recovery.md for structured troubleshooting.

4. Review & Optimize

• Code review: Use code-review-and-quality.md for 5-axis quality checks.
• Simplify code: Use code-simplification.md to reduce complexity.
• Security: Use security-and-hardening.md for OWASP standards and hardening.
• Performance: Use performance-optimization.md for measurement-based optimization.

5. Ship & Maintain

• Git workflow: Use git-workflow-and-versioning.md for clean, atomic commits.
• CI/CD: Use ci-cd-and-automation.md for automated quality gates.
• Documentation: Use documentation-and-adrs.md to document the "why" (ADRs).
• Migration: Use deprecation-and-migration.md for safe system transitions.
• Shipping: Use shipping-and-launch.md for pre-launch checklists.

Core Operating Behaviors

These behaviors apply across all workflows:

1. Surface Assumptions: Explicitly state assumptions before starting non-trivial work.
2. Manage Confusion: Stop and clarify when faced with inconsistencies.
3. Push Back: Propose better alternatives when an approach has clear downsides.
4. Enforce Simplicity: Resist overcomplication; prefer obvious, boring solutions.
5. Verify, Don't Assume: A task is only complete when verified with evidence (tests, logs).

How to Use These References

When you activate this skill, refer to the table above. If you are starting a new feature, read spec-driven-development.md and planning-and-task-breakdown.md first. For implementation, load incremental-implementation.md.

Tip: You can use grep_search to find specific rules within the reference files if they are large.