Include reference example generator in docs:all and highlight it in readme

Author: darko-mijic

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+labels: bug
+---
+
+## Describe the Bug
+
+A clear description of what the bug is.
+
+## To Reproduce
+
+Steps to reproduce the behavior:
+
+1. Run `...`
+2. With config `...`
+3. See error
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Error Output
+
+```
+Paste any error messages or unexpected output here.
+```
+
+## Environment
+
+- **Node.js version:** (e.g., 20.10.0)
+- **Package version:** (e.g., 1.0.0-pre.0)
+- **OS:** (e.g., macOS 15, Ubuntu 24.04)
+- **Package manager:** (npm / pnpm / yarn)
+
+## Additional Context
+
+Any other context — config files, feature files, annotation examples — that helps explain the problem.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,21 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+labels: enhancement
+---
+
+## Is your feature request related to a problem?
+
+A clear description of the problem. Ex. "I'm always frustrated when..."
+
+## Describe the Solution You'd Like
+
+A clear description of what you want to happen.
+
+## Describe Alternatives You've Considered
+
+Any alternative solutions or features you've considered.
+
+## Additional Context
+
+Any other context — use cases, examples, screenshots — that helps explain the request.

CHANGELOG.md

@@ -5,6 +5,8 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
 ## [1.0.0-pre.0] - 2026-02-21
 
 First npm-published pre-release for monorepo validation.
@@ -24,3 +26,6 @@ First npm-published pre-release for monorepo validation.
 - `dist/` removed from git tracking -- built fresh during publish
 - `@libar-dev/modular-claude-md` moved from dependencies to devDependencies
 - Package size trimmed (removed self-referential docs from tarball)
+
+[Unreleased]: https://github.com/libar-dev/delivery-process/compare/v1.0.0-pre.0...HEAD
+[1.0.0-pre.0]: https://github.com/libar-dev/delivery-process/releases/tag/v1.0.0-pre.0

CONTRIBUTING.md

@@ -0,0 +1,77 @@
+# Contributing to @libar-dev/delivery-process
+
+We welcome contributions! This guide covers how to get started.
+
+## Prerequisites
+
+- **Node.js** >= 18.0.0
+- **pnpm** (recommended package manager)
+- ESM project (`"type": "module"`)
+
+## Getting Started
+
+```bash
+# Fork the repo on GitHub, then:
+git clone https://github.com/<your-username>/delivery-process.git
+cd delivery-process
+pnpm install
+pnpm build && pnpm test
+```
+
+## Development Workflow
+
+```bash
+pnpm build              # Compile TypeScript
+pnpm dev                # Watch mode
+pnpm test               # Run all tests
+pnpm test <pattern>     # Run specific tests
+pnpm typecheck          # Type check without emit
+pnpm lint               # ESLint
+pnpm format:check       # Prettier check
+```
+
+## Testing Policy
+
+This package enforces **strict Gherkin-only testing**:
+
+- All tests are `.feature` files with step definitions in `.steps.ts`
+- No `.test.ts` files — exception-free policy
+- Edge cases use `Scenario Outline` with Examples tables
+- Feature files live in `tests/features/`, step defs in `tests/steps/`
+
+A package that generates documentation from `.feature` files should demonstrate that Gherkin is sufficient for testing.
+
+## Pre-commit Hooks
+
+The project uses Husky with lint-staged. On every commit:
+
+- ESLint + Prettier auto-fix on staged `.ts` files
+- Prettier on staged `.json`, `.md`, `.yml` files
+
+These run automatically — no manual setup needed after `pnpm install`.
+
+## Making Changes
+
+1. Create a branch from `main`
+2. Make your changes
+3. Run the full validation suite:
+   ```bash
+   pnpm build && pnpm test && pnpm typecheck && pnpm lint && pnpm format:check
+   ```
+4. Commit with a clear message describing the "why"
+
+## Pull Requests
+
+- PRs target the `main` branch
+- CI runs on Node.js 18, 20, and 22
+- All checks (build, test, typecheck, lint, format) must pass
+- We review for consistency with the four-stage pipeline architecture (Scanner, Extractor, Transformer, Codec)
+
+## Reporting Issues
+
+- Use [GitHub Issues](https://github.com/libar-dev/delivery-process/issues)
+- For security vulnerabilities, see [SECURITY.md](SECURITY.md)
+
+## Code of Conduct
+
+Be respectful, constructive, and inclusive. We follow the [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).