Development & AI Agents

You define the rules. You verify the result.

Your Project, Your Rules

Name: Your Project, Your Rules
Author: Régys Borges da Silveira

A practical guide to Markdown and skills for development agents.

Turn your project knowledge into clear instructions, reusable skills, and changes you can verify.

Notify me when it is available

This book is being prepared in Brazilian Portuguese.

EditionIn preparation2026Book languagePortugueseBrazilFormatsComing soonComing soon

About the book

A complete view of the book.

Your Project, Your Rules offers a path from repository knowledge to useful documents, clear instructions, and reusable procedures. It starts from the everyday work of Delphi developers, while keeping the method adaptable to other languages without requiring a change of environment.

The planned seven parts and 20 chapters begin with a ticket-system exercise, cover Markdown, directory rules, context, and skills, then move into implementation, bug investigation, testing, refactoring, and review. The companion repository includes templates, fictional data, and eight recipes. An optional JavaScript reference lets readers explore the case; the Delphi procedures guide adaptation to the reader’s own project.

The challenge

Does this situation sound familiar?

An agent changes the code but misses a rule only the team knows: which project to build, which file must not be edited directly, or which test demonstrates that the change works. How can you make that knowledge accessible without repeating everything in every request?

The book’s approach

Organize your project to guide and verify the agent’s work.

The planned journey starts with a small task and progresses through Markdown, context organization, and skills: reusable procedures for guiding a task. Each change is connected to boundaries and evidence, with final decisions remaining in the hands of the people who know the system.

“A convincing response does not replace compilation, testing, or review.”

By the end of the book, you will be able to:

✓Write Markdown instructions with verifiable criteria

✓Map a repository and distribute rules by project and directory

✓Create skills with supporting references, templates, and scripts

✓Plan features and investigate bugs within clear boundaries

✓Distinguish expected outcomes from execution evidence

✓Maintain a library of procedures reviewed by the team

Questions that guide the reading

Answers begin with the right questions.

Questions explored through context, criteria, and examples.

How can a rule known by the team become a verifiable instruction?

What belongs in project rules, and what belongs in a skill?

How can you check whether a change respected the task contract?

How can you adapt procedures across agents without assuming identical behavior?

Inside the book

A structured journey that helps you move forward.

Concepts and applications presented in a coherent sequence.

First results and foundations

Start with a small task and understand what an agent reads, decides, and executes.

Markdown and criteria

Organize documents, instructions, and acceptance conditions that can be checked.

Repository and context

Map files, distribute rules, and select useful context for each task.

Reusable skills

Create and evaluate procedures with references, templates, and scripts where needed.

Development and verification

Apply the approach to features, bugs, tests, refactoring, and change review.

Portability and maintenance

Adapt procedures across tools and maintain a shared reference kit.

Source code and examples on GitHub

Content in preparation

Planned book structure

Explore the 7 parts and 20 planned chapters. Titles may be refined during editorial review.

View chapters20 chapters

Part 1 — First results

Your first project guided by rules
What the agent reads, decides, and executes

Part 2 — Markdown for guiding agents

Markdown that helps you work
Clear instructions and verifiable criteria

Part 3 — The project as context

Mapping your repository
Rules by project and directory
Context that fits and stays useful

Part 4 — Skills in practice

Your first skill
Skills with references, templates, and scripts
How to test and improve a skill

Part 5 — Everyday development

Understand a project and plan a change
Implement a feature within clear boundaries
Investigate and fix bugs
Write tests and refactor safely
Review changes and maintain documentation

Part 6 — Working across tools

The same workflow in different agents
A portable library of procedures

Part 7 — Evolution and reference

When the agent does not behave as expected
Maintain your rules and skills as a team
Your reference kit for everyday work

What makes this book different

Depth to understand. Clarity to keep moving forward.

A progressive journey using a ticket system and fictional data

A method adaptable to different languages, grounded in Delphi development

Eight recipes and templates in a separate public repository

An explicit distinction between expected outcomes, examples, and observed execution

Who this book is for

Find your place in this book.

Delphi developers and developers in other languages working with AI agents.

✓ Delphi developers organizing their work with agents✓ Developers in other languages maintaining existing projects✓ Teams that need to version and review instructions and skills✓ Professionals who prefer learning by doing and looking up tasks

Before you begin

What you need to benefit from the book

✓Basic software development, terminal, and Git knowledge

✓A practice project or a safe copy of your repository

✓JavaScript is an optional reference; migrating your application is not required

An informed choice

This may not be the right book if…

—Readers looking for an introductory programming course

—Readers expecting instructions to remove the need for testing and human review

Why this author, on this subject

Experience that gives the reading context.

Régys Borges da Silveira is an Embarcadero MVP, developer, teacher, and instructor. His experience of over 20 years in enterprise systems and professional education connects project organization, development practice, and verification criteria.

Upcoming release

Receive resources and updates about Your Project, Your Rules.

Upcoming release