We have documentation with general coding and procedure guidelines for humans.
Current state
- Our agent instructions reference these guidelines in the hope that it would help agents.
In reality, these guidelines are too far away from agents to be taken seriously.
- These guidelines are hardly verifiable in an automated way if they are just wiki pages. AI skills solve such things already better.
- We use vibe coding more and more. The guidelines need to be oriented to AI agents with humans being in control for verification and guidance.
Proposed improvements and actions
- Gradually migrate the content of our wiki for humans eliminating the content duplication.
- If there is something described under wiki is also described under agents, the duplication must be eliminated making
wiki link to agents, instead of having the same or similar words around the topic.
- Let's start with obvious things like:
- Track the progress and suggested further steps under task documents which should link to this meta-issue.
- Update this issue description, if needed. Track progress in comments.
Verification
- When this issue is fully resolved, there should be no links to wiki from the content of this repository in the
master branch.
- During the migration process, a page at wiki should link to corresponding document under agents when the page's content is processed.
- When the migration is complete the wiki should have one page with sections, brief descriptions and links to agents.
We have documentation with general coding and procedure guidelines for humans.
Current state
In reality, these guidelines are too far away from agents to be taken seriously.
Proposed improvements and actions
wikilink toagents, instead of having the same or similar words around the topic.Verification
masterbranch.