{
  "feature": "directory-operations",
  "version": "1.0.0",
  "description": "Directory traversal and management",
  "category": "data",
  "tags": [
    "data",
    "godot"
  ],
  "actors": [
    {
      "id": "game_engine",
      "name": "Godot Engine",
      "type": "system"
    }
  ],
  "outcomes": {
    "directory_listing": {
      "given": [
        "Enumerate files and subdirectories is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Enumerate files and subdirectories completed",
      "priority": 1
    },
    "directory_creation": {
      "given": [
        "Create new directories is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Create new directories completed",
      "priority": 2
    },
    "directory_deletion": {
      "given": [
        "Remove empty directories is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Remove empty directories completed",
      "priority": 3
    },
    "path_resolution": {
      "given": [
        "Normalize and join paths is requested"
      ],
      "then": [
        {
          "action": "transition_state",
          "field": "status",
          "from": "idle",
          "to": "active"
        }
      ],
      "result": "Normalize and join paths completed",
      "priority": 4
    }
  },
  "rules": {
    "implementation": {
      "description": "Feature implemented in C++ engine core"
    },
    "platform_agnostic": {
      "description": "Works across desktop, web, mobile platforms"
    }
  },
  "related": [],
  "agi": {
    "goals": [
      {
        "id": "reliable_directory_operations",
        "description": "Directory traversal and management",
        "success_metrics": [
          {
            "metric": "data_accuracy",
            "target": "100%",
            "measurement": "Records matching source of truth"
          },
          {
            "metric": "duplicate_rate",
            "target": "0%",
            "measurement": "Duplicate records detected post-creation"
          }
        ],
        "constraints": [
          {
            "type": "performance",
            "description": "Data consistency must be maintained across concurrent operations",
            "negotiable": false
          }
        ]
      }
    ],
    "autonomy": {
      "level": "supervised"
    },
    "safety": {
      "action_permissions": [
        {
          "action": "directory_listing",
          "permission": "autonomous"
        },
        {
          "action": "directory_creation",
          "permission": "supervised"
        },
        {
          "action": "directory_deletion",
          "permission": "human_required"
        },
        {
          "action": "path_resolution",
          "permission": "autonomous"
        }
      ]
    },
    "tradeoffs": [
      {
        "prefer": "data_integrity",
        "over": "performance",
        "reason": "data consistency must be maintained across all operations"
      }
    ]
  },
  "extensions": {
    "tech_stack": {
      "language": "C++",
      "runtime": "Godot 4.x"
    }
  }
}