🌌 Portal OG: Exhaustive Blueprint

Welcome to the Portal OG autonomous development workspace. This structure follows the Google Codelab Standard for agentic systems, ensuring a clear separation between identity, logic, and proof.

🧠 Layer 1: The Intelligence Engine (.agents/)

Identity and orchestration for the autonomous Council.

• .agents/agents.md: The Council Constitution (@PM, @Architect, @QA).
• .agents/workflows/startcycle.md: The 5-Phase autonomous build loop.
• .agents/skills/: Technical capability vault (Research, Code, Verify).

📖 Layer 2: Single Source of Truth (docs/)

The machine-readable blueprints driving all agent actions.

• docs/prd.md: The Unified Product Requirements & Mission.
• docs/soul.md: Design philosophy & Premium Glassmorphic principles.
• docs/spec.md: Core Engine logic (Discovery, Hardening, Intel, Action).
• docs/architecture.md: Database schema & Unified State Machine.
• docs/test_spec.md: Autonomous verification protocols.
• docs/05_STRESS_TEST_OPERATIONS.md: Failure points, API keys & Migration.

🏛️ Layer 3: The Vault of Proof (artifacts/)

Verifiable evidence of autonomous execution.

• BUILD_LOG.md: Live progress tracking of the refactor.
• artifacts/logs/: Detailed cycle logs.
• artifacts/verify_reports/: QA sign-offs, screenshots, and test results.

---

🚀 Autonomous Execution Order

1. Infrastructure: Migrate portal_leads schema (docs/architecture.md).
2. Discovery Engine: Implement Apollo & CRM Health Check (docs/spec.md).
3. Hardening Engine: Email verification & ICP scoring.
4. Intelligence Engine: Deep Research & Tavily integration.
5. Action Engine: Unified Outreach & HITL CRM Sync.