Skip to content

feat: consolidate spec docs, improve discovery flow, add feature derivation#145

Merged
nullhack merged 3 commits into
mainfrom
feat/doc-consolidation-discovery-improvements
May 8, 2026
Merged

feat: consolidate spec docs, improve discovery flow, add feature derivation#145
nullhack merged 3 commits into
mainfrom
feat/doc-consolidation-discovery-improvements

Conversation

@nullhack
Copy link
Copy Markdown
Owner

@nullhack nullhack commented May 8, 2026

Summary

  • Consolidate spec docs: merge event_storming, context_map, technical_design templates into domain_model and product_definition templates
  • Add Events/Commands and Context Map sections to domain_model.md.template
  • Add Technology Stack and Dependencies sections to product_definition.md.template
  • Delete document-dependencies.yaml (unused)

Discovery Flow (v7 to v11)

  • Merge event-storming + language-definition + domain-modeling states into single domain-discovery state with 3 skills: facilitate-event-storming, domain-discovery, define-ubiquitous-language
  • Split feature-discovery into 2 skills: discover-features (boundary identification) and discover-rules (rule derivation)
  • Add features/*.feature to feature-discovery inputs

Architecture Flow (v7 to v8)

  • Merge adr-draft into technical-design state (skills: design-technical-solution, draft-adr)

New Knowledge Files

  • domain-modeling/domain-modeling.md — Formalization knowledge (bounded contexts, entities, relationships, aggregates)
  • requirements/feature-boundaries.md — Feature boundary derivation from delivery order, context alignment, splitting criteria
  • requirements/rule-derivation.md — Systematic rule derivation from events, invariants, commands, quality attributes

Enriched Knowledge Files

  • domain-modeling/event-storming.md — Brandolini 6 phases, extraction heuristics, hotspot detection
  • requirements/ubiquitous-language.md — Term detection heuristics, cross-referencing procedures
  • requirements/feature-discovery.md — Content section with discovery sequence and gap analysis
  • skill-design/principles.md — "read on demand" to "read all before starting work"

Skill Improvements

  • All 41 skills: updated input handling to "read all before starting work"
  • 10 skills with procedural improvements
  • New discover-rules skill (rule derivation from domain model artifacts)
  • New domain-discovery skill (convergent synthesis from event storming candidates)

Naming Conventions

  • Placeholder naming: type_id pattern (feature_id, adr_id, session_id, pm_id, rule_id)
  • All filenames use snake_case, doc folders use kebab-case

Other

  • Research docs added: Brandolini (2012), Evans (2003), Vernon (2013)
  • Added Out Artifact Protocol, cumulative editing rule, file naming rule to AGENTS.md

nullhack added 2 commits May 8, 2026 04:55
…overy improvements

Consolidated spec documents:
- Removed event_storming.md, context_map.md, technical_design.md templates
- Added Events/Commands and Context Map sections to domain_model template
- Added Technology Stack and Dependencies to product_definition template
- Merged content from deleted docs into domain_model and product_definition

Discovery flow improvements:
- Merged event-storming + language-definition + domain-modeling into single
  domain-discovery state with 3 skills: facilitate-event-storming,
  domain-discovery, define-ubiquitous-language
- Split feature-discovery into 2 skills: discover-features (boundaries)
  and discover-rules (rule derivation)
- Enriched event-storming.md knowledge with Brandolini's 6 phases
- Created domain-modeling.md knowledge (formalization)
- Enriched ubiquitous-language.md with detection heuristics

Feature discovery improvements:
- Created feature-boundaries.md knowledge (Patton story mapping, context
  alignment, splitting criteria)
- Created rule-derivation.md knowledge (Event→Rule, Invariant→Rule,
  Command→Rule, Quality Attribute→Constraint patterns)
- Enriched feature-discovery.md with Content section and gap analysis

Architecture flow: merged adr-draft into technical-design state

Naming conventions: <feature_id>, <adr_id>, <session_id>, <pm_id>, <rule_id>

Skill improvements: all 41 skills updated to read all in artifacts
before starting work; 10 skills with procedural improvements

Removed cex-mm-specific Exchange Adapter Fixtures section from AGENTS.md
…vation knowledge

- Merge event_storming, context_map, technical_design into domain_model and product_definition templates
- Add Events/Commands and Context Map sections to domain_model.md.template
- Add Technology Stack and Dependencies sections to product_definition.md.template
- Discovery flow: merge domain discovery into 3-skill state, add discover-rules to feature-discovery
- Architecture flow: merge adr-draft into technical-design state
- New knowledge: domain-modeling, feature-boundaries, rule-derivation
- Enriched knowledge: event-storming, ubiquitous-language, feature-discovery
- All skills: read all in-artifacts before starting work
- Placeholder naming: <type_id> pattern (feature_id, adr_id, session_id, pm_id, rule_id)
- Delete document-dependencies.yaml (unused)
@nullhack nullhack force-pushed the feat/doc-consolidation-discovery-improvements branch from 2a64218 to cf9dcfc Compare May 8, 2026 08:59
@nullhack nullhack changed the title feat: adopt cex-mm doc consolidation, 3-skill discovery, feature discovery improvements feat: consolidate spec docs, improve discovery flow, add feature derivation May 8, 2026
Port kebab-case naming convention from cex-mm. All flow identifiers
(transitions, conditions, evidence keys, runtime artifacts) now use
hyphens instead of underscores. Also includes select-feature skill
and AGENTS.md session param updates.
@nullhack nullhack merged commit c60950a into main May 8, 2026
10 checks passed
@nullhack nullhack deleted the feat/doc-consolidation-discovery-improvements branch May 8, 2026 09:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant