agenda-engine

Model time blocks and procedure phases for barber scheduling logic.

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/stancodev/obigode --skill agenda-engine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agenda-engine
Source: https://github.com/stancodev/obigode/tree/main/.claude/skills/agenda-engine
Command: npx skills add https://github.com/stancodev/obigode --skill agenda-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resolve a lógica de agendamento: criação, modificação ou depuração de blocos de horário, fases de procedimento, verificação de disponibilidade do barbeiro, cálculo de slots livres ou conflitos de agenda.

Core Features & Use Cases

  • Bloqueios ATIVO vs LIVRE: blocos ATIVO ocupam o barbeiro e geram conflitos; blocos LIVRE são intervalos sem conflito.
  • Cálculo de blocos: blocos criados sequencialmente a partir das fases do procedimento, respeitando a ordem de ProcedimentoFase.
  • Verificação de disponibilidade: checagem de conflitos apenas em blocos ATIVOS e BloqueioAgenda do barbeiro.
  • Busca de horários disponíveis: respeita horárioAbertura/horarioFechamento e diasFuncionamento; intervalo mínimo entre slots de 10 minutos.

Quick Start

Read the current agenda-engine.ts and run a simple block calculation for a sample procedure.

Frequently Asked Questions about agenda-engine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate sequential time blocks for a procedure with multiple phases?

To calculate sequential time blocks, you model time blocks and procedure phases sequentially, respecting the defined order of ProcedureFase. This ensures phases are created one after another without gaps.

How does scheduling availability checking handle active versus free blocks?

Scheduling availability checking distinguishes active blocks, which occupy the barber and generate conflicts, from free blocks. Conflicts are only checked against active blocks and existing schedule locks.

What is the best way to generate available time slots within operating hours?

The best way to generate available time slots is to filter by opening hours and operating days, then apply a minimum 10-minute interval between slots. This respects schedule locks and active blocks.

How do I validate a schedule and debug conflicts in a barber workflow?

You validate a schedule and debug conflicts by checking availability against active blocks and schedule locks. This logic applies to creating, modifying, or debugging time blocks and procedure phases.

Does block management support modifying existing schedule blocks without breaking sequence?

Block management supports modifying existing schedule blocks while maintaining the sequential creation logic based on procedure phases. This ensures active versus free block rules remain satisfied during modifications.