Skip to content

Commit 6079f79

Browse files
spec: add maze-printable specification (#3236)
## New Specification: `maze-printable` Related to #3232 --- ### specification.md # maze-printable: Printable Maze Puzzle ## Description A rectangular maze puzzle visualization with clearly marked start and goal positions. The maze is algorithmically generated to guarantee exactly one solution path from start to finish. The clean black-and-white design is optimized for printing, allowing users to solve the puzzle with a pen or pencil. ## Applications - Printable activity sheets for children's entertainment and education - Puzzle books and newspapers requiring programmatically generated mazes - Educational materials teaching algorithmic thinking and problem-solving - Restaurant placemats and waiting room entertainment ## Data - `width` (int) - Number of cells horizontally (recommended: 15-40) - `height` (int) - Number of cells vertically (recommended: 15-40) - `seed` (int, optional) - Random seed for reproducible maze generation - Size: Grid dimensions determine complexity (larger = harder) - Example: 25x25 grid with start at top-left, goal at bottom-right ## Notes - Use maze generation algorithms (DFS, Prim's, Kruskal's) that guarantee a single solution - Start position typically marked with "S" or arrow, goal with "G" or star - Wall thickness should be consistent and print-friendly (not too thin) - Include adequate margins for printing - Black walls on white background for maximum contrast and ink efficiency - Passage width should accommodate pen/pencil marking --- **Next:** Add `approved` label to the issue to merge this PR. --- :robot: *[spec-create workflow](https://github.com/MarkusNeusinger/pyplots/actions/runs/20794899276)* Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent bf5e0cf commit 6079f79

File tree

2 files changed

+57
-0
lines changed

2 files changed

+57
-0
lines changed
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# maze-printable: Printable Maze Puzzle
2+
3+
## Description
4+
5+
A rectangular maze puzzle visualization with clearly marked start and goal positions. The maze is algorithmically generated to guarantee exactly one solution path from start to finish. The clean black-and-white design is optimized for printing, allowing users to solve the puzzle with a pen or pencil.
6+
7+
## Applications
8+
9+
- Printable activity sheets for children's entertainment and education
10+
- Puzzle books and newspapers requiring programmatically generated mazes
11+
- Educational materials teaching algorithmic thinking and problem-solving
12+
- Restaurant placemats and waiting room entertainment
13+
14+
## Data
15+
16+
- `width` (int) - Number of cells horizontally (recommended: 15-40)
17+
- `height` (int) - Number of cells vertically (recommended: 15-40)
18+
- `seed` (int, optional) - Random seed for reproducible maze generation
19+
- Size: Grid dimensions determine complexity (larger = harder)
20+
- Example: 25x25 grid with start at top-left, goal at bottom-right
21+
22+
## Notes
23+
24+
- Use maze generation algorithms (DFS, Prim's, Kruskal's) that guarantee a single solution
25+
- Start position typically marked with "S" or arrow, goal with "G" or star
26+
- Wall thickness should be consistent and print-friendly (not too thin)
27+
- Include adequate margins for printing
28+
- Black walls on white background for maximum contrast and ink efficiency
29+
- Passage width should accommodate pen/pencil marking
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Specification-level metadata for maze-printable
2+
# Auto-synced to PostgreSQL on push to main
3+
4+
spec_id: maze-printable
5+
title: Printable Maze Puzzle
6+
7+
# Specification tracking
8+
created: 2026-01-07T20:05:58Z
9+
updated: null
10+
issue: 3232
11+
suggested: MarkusNeusinger
12+
13+
# Classification tags (applies to all library implementations)
14+
# See docs/reference/tagging-system.md for detailed guidelines
15+
tags:
16+
plot_type:
17+
- maze
18+
- grid
19+
data_type:
20+
- discrete
21+
- matrix
22+
domain:
23+
- general
24+
- education
25+
features:
26+
- basic
27+
- algorithmic
28+
- printable

0 commit comments

Comments
 (0)