sf-agent-framework/sf-core/data/document-folder-structures.yaml

AI Agent Orchestration Framework for Salesforce Development - Two-phase architecture with 70% context reduction

# Document Folder Structures Configuration
# This file defines the folder structures for each agent role and workflow type

folder-structures:
  # Orchestrator/Management Role
  sf-orchestrator:
    folders:
      - project-planning/
      - project-planning/roadmaps/
      - project-planning/timelines/
      - project-planning/meeting-notes/
      - release-management/
      - release-management/deployment-runbooks/
      - release-management/rollback-plans/
      - quality-reports/
      - quality-reports/test-results/
      - quality-reports/coverage-reports/
      - status-reports/
      - status-reports/weekly/
      - status-reports/sprint/

  # Business Analysis Roles
  sf-analyst:
    folders:
      - requirements/
      - requirements/functional/
      - requirements/non-functional/
      - requirements/user-stories/
      - requirements/acceptance-criteria/
      - process-documentation/
      - process-documentation/as-is/
      - process-documentation/to-be/
      - process-documentation/swim-lanes/
      - gap-analysis/
      - gap-analysis/feature-gaps/
      - gap-analysis/process-gaps/

  sf-business-analyst:
    folders:
      - business-requirements/
      - business-requirements/use-cases/
      - business-requirements/personas/
      - stakeholder-analysis/
      - impact-analysis/
      - training-materials/
      - training-materials/end-user/
      - training-materials/admin/

  # Product Management
  sf-platform-owner:
    folders:
      - prd/
      - prd/epics/
      - prd/features/
      - prd/user-stories/
      - product-roadmap/
      - product-roadmap/quarterly/
      - product-roadmap/annual/
      - release-notes/
      - release-notes/internal/
      - release-notes/external/
      - stakeholder-communications/
      - metrics-dashboards/

  # Architecture Roles
  sf-architect:
    folders:
      - architecture/
      - architecture/solution-design/
      - architecture/data-models/
      - architecture/integration-patterns/
      - architecture/security-design/
      - architecture/decisions/
      - architecture/diagrams/
      - technical-specifications/
      - technical-specifications/components/
      - technical-specifications/interfaces/

  sf-chief-architect:
    folders:
      - enterprise-architecture/
      - enterprise-architecture/standards/
      - enterprise-architecture/patterns/
      - enterprise-architecture/roadmap/
      - architecture-governance/
      - architecture-reviews/
      - architecture-decisions/
      - reference-architectures/

  sf-technical-architect:
    folders:
      - technical-architecture/
      - technical-architecture/system-design/
      - technical-architecture/component-design/
      - technical-architecture/performance/
      - code-architecture/
      - design-patterns/
      - proof-of-concepts/

  sf-solution-architect:
    folders:
      - solution-design/
      - solution-design/functional/
      - solution-design/technical/
      - solution-alternatives/
      - cost-benefit-analysis/
      - vendor-evaluations/
      - implementation-roadmap/

  sf-data-architect:
    folders:
      - data-architecture/
      - data-architecture/data-models/
      - data-architecture/erd-diagrams/
      - data-architecture/data-dictionary/
      - migration-plans/
      - migration-plans/mapping-documents/
      - migration-plans/validation-scripts/
      - data-quality-reports/
      - etl-documentation/
      - etl-documentation/specifications/
      - etl-documentation/job-flows/

  sf-integration-architect:
    folders:
      - integration/
      - integration/api-contracts/
      - integration/api-specifications/
      - integration/middleware-configs/
      - integration/event-schemas/
      - integration/error-handling/
      - integration/monitoring/
      - integration-patterns/
      - integration-testing/

  sf-security-architect:
    folders:
      - security-architecture/
      - security-architecture/threat-models/
      - security-architecture/controls/
      - security-policies/
      - compliance-frameworks/
      - risk-assessments/
      - security-patterns/
      - audit-trails/

  sf-omnistudio-architect:
    folders:
      - omnistudio/
      - omnistudio/omniscript-designs/
      - omnistudio/flexcard-specifications/
      - omnistudio/dataraptor-mappings/
      - omnistudio/integration-procedures/
      - omnistudio/performance-optimization/
      - omnistudio/design-standards/
      - omnistudio/component-library/

  sf-mcp-architect:
    folders:
      - mcp-architecture/
      - mcp-architecture/agent-designs/
      - mcp-architecture/tool-specifications/
      - mcp-architecture/server-configs/
      - mcp-architecture/client-integrations/
      - mcp-patterns/
      - mcp-security/
      - mcp-monitoring/

  # Development Roles
  sf-developer:
    folders:
      - development/
      - development/code-documentation/
      - development/api-documentation/
      - development/component-specs/
      - development/unit-tests/
      - development/deployment-packages/
      - development/release-bundles/
      - code-reviews/
      - technical-debt/

  sf-admin:
    folders:
      - configuration/
      - configuration/metadata/
      - configuration/flows/
      - configuration/validation-rules/
      - configuration/workflows/
      - declarative-solutions/
      - admin-guides/
      - admin-guides/setup/
      - admin-guides/maintenance/
      - change-sets/

  # Quality Assurance
  sf-qa:
    folders:
      - quality-assurance/
      - quality-assurance/test-plans/
      - quality-assurance/test-cases/
      - quality-assurance/test-scripts/
      - quality-assurance/test-results/
      - quality-assurance/bug-reports/
      - quality-assurance/performance-reports/
      - quality-assurance/regression-suites/
      - quality-assurance/uat-scenarios/
      - quality-metrics/

  # Security
  sf-security:
    folders:
      - security/
      - security/assessments/
      - security/vulnerability-scans/
      - security/penetration-tests/
      - security/compliance-reports/
      - security/access-reviews/
      - security/permission-audits/
      - security/policies/
      - security/incident-reports/
      - security/remediation-plans/

  # DevOps
  sf-devops:
    folders:
      - devops/
      - devops/pipeline-configs/
      - devops/deployment-scripts/
      - devops/environment-configs/
      - devops/monitoring-dashboards/
      - devops/runbooks/
      - devops/automation-scripts/
      - devops/backup-procedures/
      - infrastructure/
      - infrastructure/diagrams/

  sf-devops-lead:
    folders:
      - devops-strategy/
      - devops-governance/
      - devops-metrics/
      - pipeline-architecture/
      - toolchain-documentation/
      - devops-training/
      - automation-framework/
      - continuous-improvement/

  # Specialized Roles
  sf-release-manager:
    folders:
      - release-management/
      - release-management/release-plans/
      - release-management/deployment-schedules/
      - release-management/release-notes/
      - release-management/go-live-checklists/
      - release-management/rollback-procedures/
      - release-management/post-release/
      - release-calendar/
      - release-communications/

  sf-data-migration-specialist:
    folders:
      - data-migration/
      - data-migration/source-analysis/
      - data-migration/mapping-documents/
      - data-migration/transformation-rules/
      - data-migration/validation-reports/
      - data-migration/error-logs/
      - data-migration/reconciliation/
      - migration-scripts/
      - migration-tools/

  sf-coe-director:
    folders:
      - governance/
      - governance/standards/
      - governance/policies/
      - governance/procedures/
      - governance/best-practices/
      - governance/compliance/
      - training-programs/
      - training-programs/technical/
      - training-programs/business/
      - metrics-dashboards/
      - metrics-dashboards/adoption/
      - metrics-dashboards/quality/
      - innovation-lab/

  sf-translator:
    folders:
      - translations/
      - translations/technical-to-business/
      - translations/business-to-technical/
      - glossaries/
      - communication-templates/
      - stakeholder-guides/
      - executive-summaries/

# Workflow-specific folder configurations
workflow-folders:
  salesforce-greenfield-fullstack:
    include-agents:
      - sf-orchestrator
      - sf-analyst
      - sf-business-analyst
      - sf-platform-owner
      - sf-architect
      - sf-technical-architect
      - sf-data-architect
      - sf-integration-architect
      - sf-security-architect
      - sf-developer
      - sf-admin
      - sf-qa
      - sf-security
      - sf-devops
      - sf-release-manager
    additional-folders:
      - project-initiation/
      - project-initiation/charter/
      - project-initiation/kickoff/
      - reference-architecture/
      - vendor-documentation/
      - lessons-learned/

  salesforce-brownfield-enhancement:
    include-agents:
      - sf-analyst
      - sf-architect
      - sf-developer
      - sf-admin
      - sf-qa
      - sf-devops
    additional-folders:
      - existing-system-analysis/
      - existing-system-analysis/current-state/
      - existing-system-analysis/dependencies/
      - change-impact-analysis/
      - regression-planning/
      - backward-compatibility/

  salesforce-data-migration:
    include-agents:
      - sf-data-architect
      - sf-data-migration-specialist
      - sf-analyst
      - sf-qa
      - sf-devops
    additional-folders:
      - data-profiling/
      - data-cleansing/
      - migration-waves/
      - cutover-planning/
      - data-validation/
      - reconciliation-reports/

  salesforce-devops-cicd:
    include-agents:
      - sf-devops
      - sf-devops-lead
      - sf-security
      - sf-qa
      - sf-developer
    additional-folders:
      - automation-framework/
      - pipeline-templates/
      - environment-provisioning/
      - monitoring-alerts/
      - performance-baselines/

  salesforce-architecture-review:
    include-agents:
      - sf-chief-architect
      - sf-architect
      - sf-technical-architect
      - sf-solution-architect
      - sf-security-architect
    additional-folders:
      - review-findings/
      - recommendations/
      - remediation-plans/
      - architecture-debt/
      - future-state-design/

  salesforce-center-of-excellence:
    include-agents:
      - sf-coe-director
      - sf-chief-architect
      - sf-platform-owner
      - sf-devops-lead
    additional-folders:
      - coe-charter/
      - operating-model/
      - maturity-assessments/
      - adoption-metrics/
      - innovation-pipeline/
      - knowledge-base/

  salesforce-mcp-implementation:
    include-agents:
      - sf-mcp-architect
      - sf-architect
      - sf-developer
      - sf-security
      - sf-devops
    additional-folders:
      - mcp-designs/
      - agent-specifications/
      - tool-library/
      - integration-tests/
      - deployment-guides/

  omnistudio-implementation:
    include-agents:
      - sf-omnistudio-architect
      - sf-developer
      - sf-admin
      - sf-qa
    additional-folders:
      - omnistudio-components/
      - design-system/
      - performance-tests/
      - migration-guides/
      - best-practices/

# Common folders added to all workflows
common-folders:
  - project-info/
  - project-info/contacts/
  - project-info/schedules/
  - meeting-notes/
  - meeting-notes/steering-committee/
  - meeting-notes/technical/
  - meeting-notes/standup/
  - decisions/
  - decisions/technical/
  - decisions/business/
  - risks-issues/
  - risks-issues/risk-register/
  - risks-issues/issue-log/
  - archived/

# Folder creation rules
folder-rules:
  create-readme: true # Create README.md in each folder
  preserve-existing: true # Don't overwrite existing folders
  create-templates: false # Don't auto-create template files
  max-depth: 3 # Maximum folder nesting level
  naming-convention: "lowercase-hyphenated" # Folder naming standard