Refactor test documentation and improve consistency in comments

Add comprehensive documentation and guidelines for various roles

Add comprehensive tests for cache management, composite indexes, enum fields, and Pinecone integration

feat(04): Agent KG migration for generic_specialist, PO, BA

test(03): add integration tests covering V-01 through V-10 criteria

feat(03): refactor JudgeGate to accept quality metrics with arbitration hierarchy

refactor(01-01): deduplicate AgentState into single definition in state.py

updated with new prompts and new workflow to generate a document