# Indicator Buffer

> Indicator Buffer is an Agent Skill for development published in the facioquo/stock-indicators-dotnet repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Implement BufferList incremental indicators with efficient state management. Use for IIncrementFromChain or IIncrementFromBar implementations. Covers interface selection, constructor patterns, and BufferListTestBase testing requirements.

- Skill name: `indicator-buffer`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/facioquo/stock-indicators-dotnet/blob/HEAD/.agents/skills/indicator-buffer/SKILL.md
- Repository: facioquo/stock-indicators-dotnet (1,224 GitHub stars when collected)

## SKILL.md

# BufferList indicator development

## Interface selection

| Interface | Additional Inputs | Use Case |
| --------- | ----------------- | -------- |
| `IIncrementFromChain` | `IReusable`, `(DateTime, double)` | Chainable single-value indicators |
| `IIncrementFromBar` | (none — only IBar from base) | Requires OHLCV properties |

See [references/interface-selection.md](references/interface-selection.md) for decision tree.

## Constructor pattern

The chaining constructor parameter type depends on the interface implemented:

```csharp
// IIncrementFromChain — chaining ctor takes IReadOnlyList<IReusable>
public class EmaList : BufferList<EmaResult>, IIncrementFromChain, IEma
{
    public EmaList(int lookbackPeriods)
    {
        Ema.Validate(lookbackPeriods);
        LookbackPeriods = lookbackPeriods;
        _buffer = new Queue<double>(lookbackPeriods);
    }

    public EmaList(int lookbackPeriods, IReadOnlyList<IReusable> values)
        : this(lookbackPeriods) => Add(values);
}
```

```csharp
// IIncrementFromBar — chaining ctor takes IReadOnlyList<IBar>
public class AdxList : BufferList<AdxResult>, IIncrementFromBar, IAdx
{
    public AdxList(int lookbackPeriods)
    {
        Adx.Validate(lookbackPeriods);
        LookbackPeriods = lookbackPeriods;
    }

    public AdxList(int lookbackPeriods, IReadOnlyList<IBar> bars)
        : this(lookbackPeriods) => Add(bars);
}
```

## Buffer management

- `_buffer.Update(capacity, value)` — standard rolling buffer
- `_buffer.UpdateWithDequeue(capacity, value)` — returns dequeued value for sum adjustment

## State management

Use `Clear()` to reset all internal state:

```csharp
public override void Clear()
{
    base.Clear();
    _buffer.Clear();
    _bufferSum = 0;
}
```

## Testing constraints

- Inherit `BufferListTestBase`
- `IIncrementFromChain` → implement `ITestChainBufferList`
- `IIncrementFromBar` → implement `ITestBarBufferList`
- Series parity: `bufferResults.IsExactly(seriesResults)`

## Required implementation

- [ ] Source code: `src/**/{IndicatorName}List.cs` file exists
  - [ ] Inherits `BufferList<TResult>` and implements correct increment interface
  - [ ] Two constructors: primary + chaining via `: this(...) => Add(...);`
  - [ ] Uses `BufferListUtilities.Update()` or `UpdateWithDequeue()`
  - [ ] `Clear()` resets results and all internal buffers
- [ ] Unit testing: `tests/Library/Indicators/**/{IndicatorName}BufferListTests.cs` exists
  - [ ] Inherits `BufferListTestBase` and implements correct test interface
  - [ ] All required abstract + interface methods implemented
  - [ ] Verifies equivalence with Series results
- [ ] **Catalog registration**: Registered in `Catalog.Listings.cs`
- [ ] **Performance benchmark**: Add to `tools/performance/Perf.Buffer.cs`
- [ ] **Public documentation**: Update `docs/indicators/{IndicatorName}.md`
- [ ] **Regression tests**: Add to `tests/Library/Indicators/**/{IndicatorName}RegressionTests.cs`
- [ ] **Migration guide**: Update `docs/migration/v3.md` for notable and breaking changes from v2

---

Source: https://www.openparable.com/skill/development/indicator-buffer (OpenParable). Cite the canonical URL above.
