skills.py

"""
Onboarding skills and Box folder routing.

All folder IDs below are dummy placeholders for illustration only. Replace each
value with real folder IDs from your own Box tenant before running the agent.
Employee names and departments are fictional demo personas, not real people.
"""

ONBOARDING_ROOT_FOLDER_ID = "YOUR_ONBOARDING_ROOT_FOLDER_ID"  # e.g. HR / Onboarding
SHARED_TEMPLATE_FOLDER_ID = "YOUR_SHARED_TEMPLATES_FOLDER_ID"  # e.g. ... / _Templates

EMPLOYEE_PROFILES = {
    "sarah_chen": {
        "employee_name": "Sarah Chen",
        "aliases": ["sarah chen", "sarah", "chen"],
        "department": "Engineering",
        "employee_folder_id": "YOUR_SARAH_CHEN_PACKET_FOLDER_ID",
        "resources_folder_id": "YOUR_SARAH_CHEN_RESOURCES_FOLDER_ID",
        "plan_file_hint": "Engineering_Onboarding_Plan",
        "welcome_file_hint": "Welcome_Note",
    },
    "marcus_rivera": {
        "employee_name": "Marcus Rivera",
        "aliases": ["marcus rivera", "marcus", "rivera"],
        "department": "Marketing",
        "employee_folder_id": "YOUR_MARCUS_RIVERA_PACKET_FOLDER_ID",
        "resources_folder_id": "YOUR_MARCUS_RIVERA_RESOURCES_FOLDER_ID",
        "plan_file_hint": "Marketing_Onboarding_Plan",
        "welcome_file_hint": "Welcome_Note",
    },
    "jordan_lee": {
        "employee_name": "Jordan Lee",
        "aliases": ["jordan lee", "jordan", "lee"],
        "department": "Sales",
        "employee_folder_id": "YOUR_JORDAN_LEE_PACKET_FOLDER_ID",
        "resources_folder_id": "YOUR_JORDAN_LEE_RESOURCES_FOLDER_ID",
        "plan_file_hint": "Sales_Onboarding_Plan",
        "welcome_file_hint": "Welcome_Note",
    },
}

REPORT_OUTPUT_FOLDER_ID = "YOUR_REPORT_OUTPUT_FOLDER_ID"
REPORT_FILE_PREFIX = "Onboarding_Readiness_Report"


SKILLS = {
    "policy_briefing": {
        "description": (
            "Reviews the standard HR packet and employee-specific docs so the "
            "manager can confirm onboarding readiness and missing paperwork."
        ),
        "prompt": """
            You are an HR onboarding coordinator.

            Your job:
            - Confirm the employee packet contains the offer letter, NDA, handbook,
              IT setup checklist, welcome note, and any role-specific starter docs.
            - Separate company-wide requirements from employee-specific paperwork.
            - Identify anything that appears missing or that still needs manager action.
            - For sensitive documents like offer letters and NDAs, only report status,
              owner, and next action. Do not expose compensation, addresses, or clause text.
            - Cite file names whenever possible.

            Keep the brief practical for a hiring manager, not legalistic.
        """,
        "folder_ids": [SHARED_TEMPLATE_FOLDER_ID, ONBOARDING_ROOT_FOLDER_ID],
    },
    "role_ramp_planner": {
        "description": (
            "Summarizes the employee's department-specific onboarding plan into "
            "clear first-week and second-week milestones."
        ),
        "prompt": """
            You are a department onboarding manager.

            Your job:
            - Find the employee's onboarding plan and welcome guidance.
            - Summarize Week 1 and Week 2 expectations.
            - Call out meetings, shadowing, starter tasks, and outcomes.
            - Highlight anything that should be scheduled before day one.

            The goal is a crisp manager-ready ramp plan.
        """,
        "folder_ids": [ONBOARDING_ROOT_FOLDER_ID],
    },
    "resource_readiness": {
        "description": (
            "Assesses whether the employee has the right tools, systems, and "
            "reference guides to be productive on day one."
        ),
        "prompt": """
            You are an onboarding enablement specialist.

            Your job:
            - Review the employee's resource guides and access materials.
            - Identify which systems or assets matter for day-one readiness.
            - Flag likely blockers such as account provisioning, missing access,
              or required setup steps.
            - Recommend the single most important pre-start action for the manager.
            - Only include resources that belong to this employee's department.

            Be specific about the tool or guide names.
        """,
        "folder_ids": [ONBOARDING_ROOT_FOLDER_ID],
    },
}