Skip to content

Guide
Domain
Decisions
Conventions
Tooling
Derivations
Backlog
Epics
Research
Process
Playbook
References
API
Playground

Sidebar Navigation

Guide

Overview
E01 — Drawing symbol shapes from numbers
F01 — A rectangle with rounded corners
F02 — A regular polygon with rounded corners
F03 — A rounding for each corner
F04 — Turning a shape by any angle
F06 — A polygon stretched to its box
F07 — A polygon anchored in its box
F08 — Moving, adding and deleting points
F09 — The rectangle, a free shape you can stretch

Domain

Overview
Configuration
Editions — free V1 and pro edition
Interaction
Shapes
Symbols, views and pipes

Decisions

Overview
ADR-0001 — Geometric scope: segments and circular arcs
ADR-0002 — Everything is a path, except text
ADR-0003 — Integer model, derived geometry
ADR-0004 — Orthogonal pipes only
ADR-0005 — Parametric pipeline: numbers → maths → SVG
ADR-0006 — Non-destructive boolean operations
ADR-0007 — Corner radius clamping: local proportional reduction
ADR-0008 — Instance rotation by quarter turns
ADR-0009 — Toolchain: TypeScript 6, Vite, Vitest, ESLint, Prettier, VitePress
ADR-0010 — Strictness carried by ESLint first, TypeScript second
ADR-0011 — Function kinds: `@kind` tag and per-kind limits
ADR-0012 — One `index.ts` per folder, canonical import paths
ADR-0013 — Prettier next to ESLint, not inside it
ADR-0014 — Functional core, imperative shell
ADR-0015 — One export per file, named like the file
ADR-0016 — Explicit inputs: no default nor optional parameter in the library
ADR-0017 — Agile backlog kept in the repository
ADR-0018 — Bézier curves allowed in static drawings only
ADR-0019 — Kebab-case file names, one export per file
ADR-0020 — Every feature starts with a research spike and ends with an audit
ADR-0021 — Agent working environment: skills, rules, hooks and an independent auditor
ADR-0022 — Property-based tests, weekly link check, mutation tool deferred
ADR-0023 — Inspection cadence: demo at each feature, review and retrospective at each epic
ADR-0024 — Session journal and transcript search instead of a database
ADR-0025 — A portable core: any JavaScript engine, transcribable to another language
ADR-0026 — Contributions through issues only; the agent writes every change
ADR-0027 — Acceptance criteria as requirements, tests traced to them, a test report per release
ADR-0028 — Feature branches and autonomous runs: stories merge into their feature, the Product Owner merges the feature
ADR-0029 — One requested corner radius per vertex in the model
ADR-0030 — A finished free V1, then new features in a paid edition
ADR-0031 — A free shape keeps the fractional vertices of a converted polygon
ADR-0032 — The rectangle is a free shape, stretched by its width and height
ADR-0033 — A free shape of corners, fractions until edited, points typed in the SVG's coordinates
ADR-0034 — Only the coordinate typed is an integer; edits keep the fractions
ADR-0035 — An angle and a position for every shape
ADR-0037 — A stretched option for the regular polygon
ADR-0038 — A `develop` branch, checks run locally, one CI on the pull request into `main`
ADR-0039 — A local library of the sources read: SQLite full-text search behind an MCP server
ADR-0040 — `AGENTS.md` holds the rules for any coding agent

Conventions

Overview
Architecture
Feature audit
Code documentation (TSDoc)
Files
Formatting
Functions
Imports
ESLint
Naming
Tests
TypeScript
Writing documentation

Tooling

Overview
Agent configuration
Continuous integration
Commands
Dependencies
Documentation site
Git workflow
Metrics of the agent's work
Releases
Local source library
Versions and security

Derivations

Overview
DERIV-arc-bounding-box — The straight box of a contour of segments and fillet arcs
DERIV-fillet-arc — Tangent points, center and SVG flags of a corner fillet
DERIV-fillet-setback — Setback of a corner fillet
DERIV-free-shape-stretch — Stretching a free shape by its width and height, without loss
DERIV-local-radius-clamp — Local proportional reduction of corner radii
DERIV-regular-polygon-fit — Regular polygon fitted uniformly in a box
DERIV-round-shape — A circle or a capsule as a rectangle rounded by half its smaller side
DERIV-stretched-polygon — A polygon stretched to its box, sides equal while its corners stay sound
DERIV-turned-shape — A shape turned about the center of its box, and kept in place when edited
DERIV-turning-angle — Turning angle at a contour vertex

Backlog

Overview

Epics

Overview
E01 — Draw symbol shapes from numbers
E02 — Edit shapes with precision
E03 — Combine shapes without losing their numbers
E04 — Give shapes exact strokes
E05 — Build animatable symbols
E06 — Configure business types in cascade
E07 — Publish business symbol libraries
E08 — Assemble synoptic views
E09 — Connect symbols with orthogonal pipes
E10 — Draw and reuse static drawings
E11 — Store and share as files in a working folder
E12 — Release a product people can trust
E13 — Arrange shapes in a tree and lay them out
E14 — Draw curves with handles, ellipses and round shapes
E15 — Place text in symbols

Research

Overview

Process

Overview
The method on one page
Feedback on the agent's work
History before 0.1.0
Improvement log
Journal

Playbook

Overview
Working with the agent
Start-of-project interview
Lessons
Principles
Process
Starter kit

References

Bibliography

API

Overview
Type Aliases
- Alignment
  Anchor
  Arc
  BoundingBox
  ClickKeys
  ContourPiece
  Corner
  CornerPoints
  DeletionOutcome
  FreeShape
  KeptPoint
  Point
  Rectangle
  RegularPolygon
  Segment
  ShapePlacement
  Size
  TurnedBox
  TurnedSize
  Vector
  VertexSelection
  ViewBox
Variables
- ALIGNMENTS
  BISECTION_STEPS
  DEGREES_PER_TURN
  EPSILON
  HALF_SIDE
  MIN_FREE_SHAPE_POINTS
  NO_VERTEX_SELECTION
  RECTANGLE_CORNER_COUNT
  REGULAR_POLYGON_CORNER_RANGE
  STRETCH_LOG_BOUND
  SVG_DECIMALS
  SVG_NAMESPACE
Functions
- add
  alignmentFactor
  arcAxisPoints
  areFreeShapePoints
  areValidRadii
  bisection
  boundingBox
  boxAspect
  boxCenter
  commonRadius
  contourBoundingBox
  contourPiecesToPathData
  contourToPathData
  cornerSetbacks
  cornersWithRadii
  createPathElement
  createSvgElement
  cyclicItem
  degreesInTurn
  deletionOutcome
  dot
  edgeFactor
  edgeFactors
  edgeLengths
  edgeOfSelection
  effectiveCornerRadius
  effectiveRadii
  filletArc
  filletSetback
  fitInBox
  formatArcCommand
  formatCoordinatePair
  formatSvgNumber
  freeShapeAroundCorners
  freeShapeContour
  freeShapeCorners
  freeShapeKeptInPlace
  freeShapeRadii
  freeShapeWithMidpoint
  freeShapeWithoutPoints
  freeShapeWithPoint
  hasLength
  isAnchor
  isModelSize
  isRegularPolygonCornerCount
  isShapeAngle
  isShapePlacement
  isSoundStretch
  isValidFreeShape
  isValidRectangle
  isValidRegularPolygon
  midpoint
  mirrorAcrossAxis
  norm
  perpDot
  positionAfterResize
  positionKeepingPoint
  quarterTurn
  radiiWithSelection
  rectangleAsFreeShape
  rectangleContour
  rectangleCorners
  regularPolygonAsFreeShape
  regularPolygonContour
  regularPolygonCorners
  resizeRadii
  roundedContour
  scale
  selectionAfterClick
  selectionAfterHandleClick
  selectionAfterRange
  selectionAfterRowClick
  selectionAfterToggle
  stretchedPolygon
  stretchedRightHalf
  stretchedSideDirections
  stretchScale
  stretchToSize
  subtract
  turnAbout
  turnDirection
  turnedCorners
  turningAngle
  turningAngles
  unit
  unitRegularPolygon
  unitStretchedPolygon
  vertexFactors

On this page

Retrospectives

One record per epic retrospective (RET story, ADR-0023), named E01-retrospective.md. Template: _retrospective.md in this folder (not published).

Epic	Record
E01	E01-retrospective.md

Pager

Next pageOverview