management

Management Skill

Trigger

This skill activates when the user wants to manage their organization: hiring or firing employees, creating departments, promoting or demoting staff, delegating tasks, reviewing task boards, or restructuring teams.

Organization Structure

The organization lives under the org/ directory in the {{portalName}} home folder (~/.jinn/org/). Each department is a subdirectory containing employee persona YAML files and a task board.

org/
  engineering/
    department.yaml
    board.json
    lead-developer.yaml
    backend-dev.yaml
  marketing/
    department.yaml
    board.json
    seo-specialist.yaml

Rank Definitions

• executive - Full access. Can see all departments and boards. Can hire and fire anyone across the entire organization.
• manager - Can manage their own department. Can hire within their department. Can see and manage their department's board.
• senior - Can update their own tasks. Can mentor other employees in the department.
• employee - Can update their own tasks only.

Operations

Hiring an Employee

Create a persona YAML file at org/<department>/<name>.yaml.

Required fields:

• name - kebab-case identifier (must match filename without extension)
• displayName - human-readable name
• department - department this employee belongs to (must match parent directory name)
• rank - one of: executive, manager, senior, employee
• engine - AI engine to use: claude or codex
• model - model identifier (e.g., sonnet, opus, o3)
• persona - multiline description of who this employee is and how they behave
• reportsTo - (optional) who this employee reports to (employee name)

Auto-determining reportsTo when the user does not specify:

1. Find the highest-ranked employee in the target department (manager > senior > employee)
2. If a manager exists → set reportsTo: <manager-name>
3. If only seniors exist → set reportsTo: <first-senior-alphabetically>
4. If the department is empty → omit reportsTo (smart defaults attach to root)
5. Confirm to the user: "Assigned X to report to Y. Change this?"