ADSM: top-level directories
The motivation for the AFKP approach is explained in the article "When Knowledge Is Too Much". This excerpt corresponds to AFKP stage 2 (resonance). Habr also published another variant of the first two AFKP stages – engagement and resonance. This is a more compact version of the text for the resonance stage.
In ADSM I divide a project into two broad areas: code and documentation. The code depends on the chosen programming language, and the documentation I further split into three zones:
- agent – a zone for communicating with agents, where reports and prompt templates are recorded;
- product – the business description of the product that sets the skeleton of the future application and shapes the agent’s field of action;
- rules – a set of regulations that describe how the software product should be created on the chosen language.
This directory structure reflects my experience working with LLM agents and is designed so that documentation and code coexist as a single space that takes into account the linguistic nature of models and their statistical limitations. It helps keep the agent focused and steer its work within the required boundaries.