cryptofoundry

Contact cryptofoundry

Tell us what you want to build or automate.

Dev Guidelines & Docs

AI agent workflow: environment bootstrap and fast/full validation for ADAMANT Node

al-onyxprotocolFrom the foundry ↗

The AI-agent documentation for the ADAMANT Node has been updated based on practical verification in a local development environment (see PR #165). This update introduces a two-level validation policy for AI contributors: fast validation by default, and full validation for critical changes. It also provides an explicit environment bootstrap checklist for PostgreSQL, Redis, and testnet startup, along with concrete health checks like pg_isready and redis-cli ping before running tests.

Because this is a legacy codebase, the documentation includes practical fallback guidance for current ESLint and tooling drift, clarifying that the repository currently has no Prettier workflow and relies on ESLint. These improvements enhance the repeatability of AI-assisted work, reduce false negatives caused by missing local services, and maintain reliability and consensus safety as the primary quality gate.

The workflow was tested end-to-end locally, confirming testnet startup with ADAMANT started and Blockchain ready messages, followed by a successful execution of the fast unit suite via npm run test:unit:fast. This approach is proposed as the baseline AI workflow for the node repository. Related discussion is tracked in issue #166.