advpl-tlpp-sdd

Orchestrate Spec-Driven Development for Protheus ADVPL/TLPP projects across Specify, Design, Tasks, and Execute phases.

115|54|Updated May 25, 2026
One-click install
npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill advpl-tlpp-sdd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: advpl-tlpp-sdd
Source: https://github.com/totvs/engpro-advpl-tlpp-skills/tree/main/skills/advpl-tlpp/advpl-tlpp-sdd
Command: npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill advpl-tlpp-sdd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you plan and implement Protheus ADVPL/TLPP projects without losing clarity by turning ambiguous feature work into a structured, verification-first workflow across adaptive phases.

Core Features & Use Cases

  • Adaptive 4-phase workflow: Specify → Design → Tasks → Execute, with auto-sizing depth based on complexity (Small/Medium/Large/Complex).
  • Atomic planning with verification criteria: Generates granular tasks with explicit “Done when” checks and gate expectations.
  • Requirement traceability & persistent state: Maintains decisions/blockers/ideas across sessions via project STATE memory.
  • Brownfield-friendly project initialization: Supports starting new projects and mapping existing codebases before designing features.
  • Safety rules for Protheus code execution: Enforces encoding conversion (UTF-8 → CP-1252) after code generation and strong verification steps before commit.

Quick Start

Use the advpl-tlpp-sdd skill when you want to specify and implement a Protheus feature end-to-end, including verification, by telling the agent to initialize the project (or map the current codebase) and then specify the feature to build.

Frequently Asked Questions about advpl-tlpp-sdd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan and implement Protheus ADVPL features without losing track of requirements?

Spec-driven development for Protheus ADVPL features orchestrates work across Specify, Design, Tasks, and Execute phases. It decomposes ambiguous requirements into atomic tasks with explicit verification criteria, ensuring requirement traceability and persistent state memory across sessions.

How do I map an existing Protheus codebase before designing a new feature?

Mapping an existing Protheus codebase uses a brownfield initialization event to load project context before feature design. This process analyzes your current ADVPL/TLPP sources and establishes a baseline state, enabling accurate feature planning and implementation within existing project structures.

How do I handle UTF-8 to CP-1252 encoding conversion for generated Protheus source files?

UTF-8 to CP-1252 encoding conversion is automatically enforced as a safety rule after generating any Protheus source files. This mandatory conversion step happens during the Execute phase, ensuring all ADVPL/TLPP code adheres to the required character encoding before commit.

Can I pause and resume Protheus feature implementation across different sessions?

You can pause and resume Protheus feature implementation using dedicated pause and resume work events. The workflow maintains decisions, blockers, and ideas through persistent STATE memory, allowing you to securely stop and continue spec-driven development tasks across multiple sessions without losing context.

Does spec-driven development work for small ADVPL quick fixes or only large features?

Spec-driven development for ADVPL supports both small quick fixes and large complex features through auto-sizing depth. The workflow adapts its Specify, Design, Tasks, and Execute phases based on complexity, ensuring appropriate verification steps whether handling minor adjustments or full-scale Protheus implementations.

What is the best way to ensure verification before committing TLPP code changes?

The best way to verify TLPP code changes is using the workflow's built-in validation and work verification events. These steps enforce strong verification gates with explicit "Done when" checks and mandatory CP-1252 encoding conversion, ensuring code quality before any commit is made.