Skip to content

Uc004 Cpp

# specs/domain/features/UC004-cpp.feature
#
# SINGLE SOURCE OF TRUTH for C++ repository initialization behaviour without scaffolding.
# This file is:
#   (1) referenced by specs/domain/use_cases/UC004-init_repo_no_scaffolding.md  (documentation)
#   (2) executed by the acceptance test suite                                   (living documentation)
#
# Rules:
#   - Scenario IDs (e.g. UC004-CPP-S01) must match the use case document.
#   - Step definitions live in: internal/acceptance/
#   - Keep scenarios focused: one behaviour per scenario.
#   - Use exact terms from specs/domain/glossary.md.

Feature: Initialize a C++ Repository (No Scaffolding)
    As a software engineer
    I want to initialize an empty Git repository with only guidelines and AI-assistant support
    So that I can choose my own CI system and build tool instead of the generator's defaults.

    # ---------------------------------------------------------------------------
    # C++ CLI Tool, no scaffolding
    # ---------------------------------------------------------------------------

    Scenario: UC004-CPP-S01 Neutral initialization skips CI, build tooling, and prescriptive ADRs
        Given current directory is an empty Git repository
        When  the user initializes this repository with the following settings:
            | Parameter           | Value            |
            | Project Name        | My C++ CLI Tool  |
            | Project Description | My C++ CLI Tool. |
            | Artifact Name       | cpp-cli-tool     |
            | Language            | cpp              |
            | Artifact Type       | tool             |
            | CI Type             | gitlab           |
            | No Scaffolding      | true             |
        Then the repository contains exactly these essential files and directories:
            | .claude/agents/code-reviewer.md                        |
            | .claude/agents/security-auditor.md                     |
            | .claude/commands/new-command.md                        |
            | .claude/commands/new-domain-object.md                  |
            | .claude/rules/bash_coding.md                           |
            | .claude/rules/ci_cd.md                                 |
            | .claude/rules/cli_tool.md                              |
            | .claude/rules/containerization.md                      |
            | .claude/rules/cpp_coding.md                            |
            | .claude/rules/data_modeling.md                         |
            | .claude/rules/error_handling.md                        |
            | .claude/rules/general_coding.md                        |
            | .claude/rules/git.md                                   |
            | .claude/rules/library_design.md                        |
            | .claude/rules/oo_design_and_programming.md             |
            | .claude/rules/performance.md                           |
            | .claude/rules/refactoring.md                           |
            | .claude/rules/security.md                              |
            | .claude/rules/spec_consistency.md                      |
            | .claude/rules/technical_writing.md                     |
            | .claude/rules/testing.md                               |
            | .claude/rules/tool_chain.md                            |
            | .claude/rules/user_experience.md                       |
            | .claude/settings.json                                  |
            | .claude/hooks/session-start.sh                         |
            | .claude/skills/adr/SKILL.md                            |
            | .claude/skills/adr/adr-template.md                     |
            | .claude/skills/arch-check/SKILL.md                     |
            | .claude/skills/commit/SKILL.md                         |
            | .claude/skills/review/SKILL.md                         |
            | .claude/skills/security-review/SKILL.md                |
            | .claude/skills/test-coverage/SKILL.md                  |
            | .claude/skills/tdd/SKILL.md                            |
            | .claude/skills/systematic-debugging/SKILL.md           |
            | .claude/skills/verification-before-completion/SKILL.md |
            | .claude/skills/update-versions/SKILL.md                |
            | .gitignore                                             |
            | .markdownlint.json                                     |
            | .mcp.json                                              |
            | .prettierignore                                        |
            | .repo.yaml                                             |
            | CHANGELOG.md                                           |
            | CLAUDE.md                                              |
            | LICENSE                                                |
            | Makefile.local                                         |
            | README.md                                              |
            | avatar/avatar.afdesign                                 |
            | cliff.toml                                             |
            | mkdocs.yml                                             |
            | specs/architecture/ADRs/ADR-001-example-decision.md    |
            | specs/architecture/APIs/consumed/README.md             |
            | specs/architecture/APIs/provided/README.md             |
            | specs/architecture/system_context.md                   |
            | specs/domain/business_rules.md                         |
            | specs/domain/domain_model.md                           |
            | specs/domain/features/UC001-sample_use_case.feature    |
            | specs/domain/glossary.md                               |
            | specs/domain/use_cases/UC001-sample_use_case.md        |
            | specs/guidelines/bash_coding.md                        |
            | specs/guidelines/ci_cd.md                              |
            | specs/guidelines/cli_tool.md                           |
            | specs/guidelines/containerization.md                   |
            | specs/guidelines/cpp_coding.md                         |
            | specs/guidelines/data_modeling.md                      |
            | specs/guidelines/error_handling.md                     |
            | specs/guidelines/general_coding.md                     |
            | specs/guidelines/git.md                                |
            | specs/guidelines/library_design.md                     |
            | specs/guidelines/oo_design_and_programming.md          |
            | specs/guidelines/performance.md                        |
            | specs/guidelines/refactoring.md                        |
            | specs/guidelines/security.md                           |
            | specs/guidelines/technical_writing.md                  |
            | specs/guidelines/testing.md                            |
            | specs/guidelines/tool_chain.md                         |
            | specs/guidelines/user_experience.md                    |
            | specs/index.md                                         |

    # ---------------------------------------------------------------------------
    # C++ Firmware/STM32, no scaffolding
    # ---------------------------------------------------------------------------

    Scenario: UC004-CPP-S02 Neutral initialization skips CI, build tooling, and prescriptive ADRs (firmware-stm32)
        Given current directory is an empty Git repository
        When  the user initializes this repository with the following settings:
            | Parameter           | Value              |
            | Project Name        | My STM32 Firmware  |
            | Project Description | My STM32 Firmware. |
            | Artifact Name       | stm32-firmware     |
            | Language            | cpp                |
            | Artifact Type       | firmware-stm32     |
            | CI Type             | gitlab             |
            | No Scaffolding      | true               |
        Then the repository contains exactly these essential files and directories:
            | .claude/agents/code-reviewer.md                        |
            | .claude/agents/security-auditor.md                     |
            | .claude/commands/new-domain-object.md                  |
            | .claude/rules/bash_coding.md                           |
            | .claude/rules/ci_cd.md                                 |
            | .claude/rules/cpp_coding.md                            |
            | .claude/rules/cpp_embedded_coding.md                   |
            | .claude/rules/data_modeling.md                         |
            | .claude/rules/error_handling.md                        |
            | .claude/rules/general_coding.md                        |
            | .claude/rules/git.md                                   |
            | .claude/rules/library_design.md                        |
            | .claude/rules/oo_design_and_programming.md             |
            | .claude/rules/performance.md                           |
            | .claude/rules/refactoring.md                           |
            | .claude/rules/security.md                              |
            | .claude/rules/spec_consistency.md                      |
            | .claude/rules/technical_writing.md                     |
            | .claude/rules/testing.md                               |
            | .claude/rules/tool_chain.md                            |
            | .claude/settings.json                                  |
            | .claude/hooks/session-start.sh                         |
            | .claude/skills/adr/SKILL.md                            |
            | .claude/skills/adr/adr-template.md                     |
            | .claude/skills/arch-check/SKILL.md                     |
            | .claude/skills/commit/SKILL.md                         |
            | .claude/skills/review/SKILL.md                         |
            | .claude/skills/security-review/SKILL.md                |
            | .claude/skills/test-coverage/SKILL.md                  |
            | .claude/skills/tdd/SKILL.md                            |
            | .claude/skills/systematic-debugging/SKILL.md           |
            | .claude/skills/verification-before-completion/SKILL.md |
            | .claude/skills/update-versions/SKILL.md                |
            | .gitignore                                             |
            | .markdownlint.json                                     |
            | .mcp.json                                              |
            | .prettierignore                                        |
            | .repo.yaml                                             |
            | CHANGELOG.md                                           |
            | CLAUDE.md                                              |
            | LICENSE                                                |
            | Makefile.local                                         |
            | README.md                                              |
            | avatar/avatar.afdesign                                 |
            | cliff.toml                                             |
            | mkdocs.yml                                             |
            | specs/architecture/ADRs/ADR-001-example-decision.md    |
            | specs/architecture/APIs/consumed/README.md             |
            | specs/architecture/APIs/provided/README.md             |
            | specs/architecture/system_context.md                   |
            | specs/domain/business_rules.md                         |
            | specs/domain/domain_model.md                           |
            | specs/domain/features/UC001-sample_use_case.feature    |
            | specs/domain/glossary.md                               |
            | specs/domain/use_cases/UC001-sample_use_case.md        |
            | specs/guidelines/bash_coding.md                        |
            | specs/guidelines/ci_cd.md                              |
            | specs/guidelines/cpp_coding.md                         |
            | specs/guidelines/cpp_embedded_coding.md                |
            | specs/guidelines/data_modeling.md                      |
            | specs/guidelines/error_handling.md                     |
            | specs/guidelines/general_coding.md                     |
            | specs/guidelines/git.md                                |
            | specs/guidelines/library_design.md                     |
            | specs/guidelines/oo_design_and_programming.md          |
            | specs/guidelines/performance.md                        |
            | specs/guidelines/refactoring.md                        |
            | specs/guidelines/security.md                           |
            | specs/guidelines/technical_writing.md                  |
            | specs/guidelines/testing.md                            |
            | specs/guidelines/tool_chain.md                         |
            | specs/index.md                                         |