F8 Features Procedure Workflow
Developmentf8-features-procedure-workflowF8 Features Procedure Workflow is an Agent Skill for development published in the TippingGame/F8Framework repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when implementing or troubleshooting Procedure feature workflows — game flow control, ProcedureNode management in F8Framework.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/TippingGame/F8Framework/blob/HEAD/Tests/AISkills/f8framework-skills/features/f8-features-procedure-workflow/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/f8-features-procedure-workflow, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Procedure Feature Workflow
⚠️ IMPORTANT: Before using this feature, you MUST formally initialize F8Framework in the launch sequence. Ensure
ModuleCenter.Initialize(this);has run first, then create the required module, for exampleFF8.Procedure = ModuleCenter.CreateModule<ProcedureManager>();.
Use this skill when
- The task is about game flow control, procedure/state management.
- The user asks about ProcedureNode, game phases, or scene-level flow transitions.
Path resolution
- Prefer project source at Assets/F8Framework.
- For usage docs, read: Assets/F8Framework/Tests/Procedure/README.md
Sources of truth
- Runtime module: Assets/F8Framework/Runtime/Procedure
- Test docs: Assets/F8Framework/Tests/Procedure
Key classes and interfaces
| Class | Role |
|---|---|
ProcedureManager | Core module. Access via FF8.Procedure. |
ProcedureNode | Abstract base class for game flow nodes. |
ProcedureProcessor | Runtime context passed to procedure lifecycle methods. |
API quick reference
// Add procedure node (optional — auto-search for ProcedureNode subclasses on init)
FF8.Procedure.AddProcedureNodes(new DemoInitState());
// Run a specific procedure
FF8.Procedure.RunProcedureNode<DemoInitState>();
// Remove procedure
FF8.Procedure.RemoveProcedureNode<DemoInitState>();
// Check existence
FF8.Procedure.HasProcedureNode<DemoInitState>();
// Get procedure node
FF8.Procedure.PeekProcedureNode(out DemoInitState initState);
// Current procedure
ProcedureNode current = FF8.Procedure.CurrentProcedureNode;
// Procedure count
int count = FF8.Procedure.ProcedureNodeCount;
ProcedureNode template
public class DemoInitState : ProcedureNode
{
public override void OnInit(ProcedureProcessor processor) { }
public override void OnEnter(ProcedureProcessor processor) { }
public override void OnUpdate(ProcedureProcessor processor) { }
public override void OnExit(ProcedureProcessor processor) { }
public override void OnDestroy(ProcedureProcessor processor) { }
}
Workflow
- Define game phases as
ProcedureNodesubclasses (Init, Login, Lobby, Battle, etc.). - Register nodes via
AddProcedureNodes()or let auto-search find them. - Start flow with
RunProcedureNode<InitState>(). - Transition between nodes by calling
RunProcedureNode<NextState>()from within a node (automatically exits current). - Use
OnEnter/OnExitfor setup/cleanup,OnUpdatefor per-frame logic. - Query current state with
CurrentProcedureNode.
Common error handling
| Error | Cause | Solution |
|---|---|---|
| Procedure not found | Not registered | Add via AddProcedureNodes() or check auto-search |
| Multiple procedures running | Calling Run without exiting current | Each Run auto-exits current node |
Cross-module dependencies
- Module: ProcedureManager is created via ModuleCenter.
- FSM: For finer-grained state control within a procedure, use FSM.
Output checklist
- Procedure nodes defined for all game phases.
- Transition flow documented.
- Files changed and why.
- Validation status and remaining risks.