{"id":50780530,"url":"https://github.com/seekdevcore/sk-requirements-engineering-theskill","last_synced_at":"2026-06-12T03:01:24.296Z","repository":{"id":363947885,"uuid":"1261941476","full_name":"seekdevcore/sk-requirements-engineering-theskill","owner":"seekdevcore","description":"Requirements Engineering corpus for AI — Claude Code skill, plugin marketplace, and MCP server (Claude Desktop, Cursor, Cline, Continue, Zed, OpenAI Responses). Methodology from IFPB ERS course + canonical bibliography (Sommerville, Pressman, Wiegers, Cohn, BABOK v3, SBC 002/2024). Bilingual: en-CA + pt-BR snapshot. CC BY-SA 4.0.","archived":false,"fork":false,"pushed_at":"2026-06-11T04:08:33.000Z","size":2563,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T04:08:41.987Z","etag":null,"topics":["agile","backlog","bdd","business-analysis","claude-code","claude-desktop","claude-skill","cline","cross-platform-ai","cursor","engenharia-de-requisitos","fastmcp","ifpb","mcp","model-context-protocol","python","requirements-engineering","scrum","user-stories"],"latest_commit_sha":null,"homepage":"https://github.com/seekdevcore/sk-requirements-engineering#readme","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-sa-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seekdevcore.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-07T11:11:30.000Z","updated_at":"2026-06-11T03:30:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/seekdevcore/sk-requirements-engineering-theskill","commit_stats":null,"previous_names":["seekdevcore/sk-requirements-engineering-theskill"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/seekdevcore/sk-requirements-engineering-theskill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seekdevcore%2Fsk-requirements-engineering-theskill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seekdevcore%2Fsk-requirements-engineering-theskill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seekdevcore%2Fsk-requirements-engineering-theskill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seekdevcore%2Fsk-requirements-engineering-theskill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seekdevcore","download_url":"https://codeload.github.com/seekdevcore/sk-requirements-engineering-theskill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seekdevcore%2Fsk-requirements-engineering-theskill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34226629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agile","backlog","bdd","business-analysis","claude-code","claude-desktop","claude-skill","cline","cross-platform-ai","cursor","engenharia-de-requisitos","fastmcp","ifpb","mcp","model-context-protocol","python","requirements-engineering","scrum","user-stories"],"created_at":"2026-06-12T03:00:41.802Z","updated_at":"2026-06-12T03:01:24.278Z","avatar_url":"https://github.com/seekdevcore.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/banner.png\" alt=\"Requirements Engineering — Claude Code Skill. Pt-BR tagline: Transformando necessidades em soluções de valor. Diagram shows the full RE journey from Discover → Analyse → Specify → Validate → Deliver, with stakeholders, elicitation, analysis, specification, validation cards, and the legend Foco no valor e no usuário (focus on value and user). Domain tags: Comunicação, Análise, Modelagem, Documentação, Negociação, Pensamento Crítico.\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n# Requirements Engineering — Claude Code Skill\n\n[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-sa/4.0/)\n[![Skill: engenharia-de-requisitos](https://img.shields.io/badge/Skill-engenharia--de--requisitos-blue)](./SKILL.md)\n[![Language: en-CA default](https://img.shields.io/badge/Language-en--CA%20(default)-success)](#language-status)\n[![Translation: pt-BR available](https://img.shields.io/badge/Translation-pt--BR%20available-yellow)](#language-status)\n[![Latest release](https://img.shields.io/github/v/release/seekdevcore/sk-requirements-engineering-theskill?label=Release\u0026color=informational)](https://github.com/seekdevcore/sk-requirements-engineering-theskill/releases/latest)\n[![CI quality](https://img.shields.io/github/actions/workflow/status/seekdevcore/sk-requirements-engineering-theskill/quality.yml?branch=main\u0026label=CI)](https://github.com/seekdevcore/sk-requirements-engineering-theskill/actions/workflows/quality.yml)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-purple.svg)](./CODE_OF_CONDUCT.md)\n\n\u003e **Skill for [Claude Code](https://claude.com/claude-code)** that loads canonical knowledge of **Requirements Engineering**, **Business Analysis**, and **Professional Ethics in Computing** into any Claude session — built from the full course material of *\"IFPB\"* (*\"Instituto Federal da Paraíba\"*) plus the canonical bibliography of the field (Sommerville, Pressman, Wiegers, Cohn, Robertson, Hull, Falbo, BABOK v3, *\"SBC\"* 002/2024).\n\n\u003e **Why some terms are kept in Brazilian Portuguese**: the primary corpus of this skill is a course taught in pt-BR, and many domain-specific entities (institutions, organizations, public-sector systems, project codenames, regulatory frameworks) lose meaning if translated. Throughout the content, such terms appear in *italic and quotes* — e.g. *\"IFPB\"*, *\"Interpop\"*, *\"ABCD\"*, *\"COB\"*, *\"Bolsa Atleta\"*, *\"LGPD\"*, *\"SBC\"*, *\"CNPq\"*. This is intentional and aligned with the CC BY-SA 4.0 attribution requirement.\n\n---\n\n## ⚡ Language status\n\n| Language | Status | Current content |\n|---|---|---|\n| **en-CA** (default declared in frontmatter) | 🟢 Complete | All content translated as of v1.2.0: entry point ([`SKILL.md`](./SKILL.md), [`README.md`](./README.md), [`CHANGELOG.md`](./CHANGELOG.md)), [`references/`](./references/) (15 files), [`examples/`](./examples/) (8 files — incl. SaaS multi-tenant / fintech / government worked case studies + `feature-step-defs/` — 6-stack BDD bindings), [`assets/`](./assets/) (scaffolder + generic template tree). Brazilian acronyms (`RF`, `RNF`, `G`, `CA`, `US`, `EP-NN`, `F-NN`, `USNN.M`, `TNN.M.K`, `TX-NN`, `G-NN`) and domain terms in *italic + quotes* preserved by design. |\n| **pt-BR** | 🟢 Complete | **Full pt-BR translation at [`translations/pt-BR/`](./translations/pt-BR/)** — a faithful mirror of the en-CA source kept current through v1.18.0 (`SKILL.md` incl. §0 first-run / §3.1 SDD / EARS, `references/` 01–13, `examples/` (8, incl. SaaS/fintech/government case studies) + `feature-step-defs/`). The original *\"IFPB\"* course language; authoritative for compliance/audit reference. |\n\n\u003e **If you read English**: every file root-level is in en-CA. The skill is fully usable end-to-end; references and examples are translated. Some pt-BR content remains by design: domain terms in *italic+quotes*, real-project artifact identifiers (Feature/AC/US titles from *\"Interpop\"* / *\"Controle de Dopagem\"*), Gherkin scenarios from the *\"IFPB\"* course material, and the `template-user-story.feature` template (with documented en-CA dialect option in its header).\n\u003e\n\u003e **Se você lê português**: o conteúdo completo em pt-BR vive em [`translations/pt-BR/`](./translations/pt-BR/) — espelho fiel da fonte en-CA, mantido até a v1.18.0 (SKILL.md com §0/§3.1/EARS, referências 01–13, exemplos (8, incl. casos SaaS/fintech/governo) + feature-step-defs/). Continua íntegro e atualizado.\n\n---\n\n## 📦 Installation\n\n\u003e **3 install paths**, depending on where you want to consume the methodology:\n\u003e\n\u003e | Path | Best for | One-liner |\n\u003e |---|---|---|\n\u003e | **Native skill** (this section) | Claude Code CLI users | `git clone … ~/.claude/skills/engenharia-de-requisitos` |\n\u003e | **Plugin marketplace** ([§Plugin install](#-claude-code-plugin-install-1-liner)) | Claude Code users who want managed install + auto-update | `/plugin marketplace add seekdevcore/sk-requirements-engineering-theskill` |\n\u003e | **MCP server** ([§MCP server](#-mcp-server-for-claude-desktop--cursor--cline--continue--zed--any-mcp-client)) | Claude Desktop · Cursor · Cline · Continue · Zed · OpenAI Responses · custom agents | `uv run requirements-engineering-mcp` |\n\n### Option 1 — Clone directly into your global skills folder (recommended)\n\n```bash\n# 1. Clone the repo into Claude Code's global skills directory\ncd ~/.claude/skills/\ngit clone git@github.com:seekdevcore/sk-requirements-engineering-theskill.git engenharia-de-requisitos\n\n# 2. Verify the skill loads\nls ~/.claude/skills/engenharia-de-requisitos/SKILL.md\n\n# 3. Open a new Claude Code session and invoke\n# (the skill auto-discovers on session start)\n```\n\n### Option 2 — Clone elsewhere and symlink\n\n```bash\n# 1. Clone wherever you keep your repos\ngit clone git@github.com:seekdevcore/sk-requirements-engineering-theskill.git ~/repos/sk-requirements-engineering\n\n# 2. Create a symlink into Claude's skills folder\nln -s ~/repos/sk-requirements-engineering ~/.claude/skills/engenharia-de-requisitos\n\n# 3. Verify\nreadlink ~/.claude/skills/engenharia-de-requisitos\n```\n\n### Option 3 — HTTPS clone (if you don't have SSH keys configured)\n\n```bash\ngit clone https://github.com/seekdevcore/sk-requirements-engineering-theskill.git ~/.claude/skills/engenharia-de-requisitos\n```\n\n### Verifying installation\n\nIn a new Claude Code session, type:\n\n```\nList the skills I have installed.\n```\n\nYou should see `engenharia-de-requisitos` in the list. Then invoke it explicitly:\n\n```\n\u003e Skill: engenharia-de-requisitos\n```\n\n---\n\n## 🧩 Claude Code plugin install (1-liner)\n\n\u003e Same skill as above, packaged as a Claude Code **plugin marketplace** — managed install + auto-update + uninstall, no manual `git clone` required.\n\nIn a Claude Code session:\n\n```text\n/plugin marketplace add seekdevcore/sk-requirements-engineering-theskill\n/plugin install engenharia-de-requisitos\n```\n\nThe skill is now available globally. Updates flow via `/plugin update`. Uninstall via `/plugin uninstall engenharia-de-requisitos`.\n\nThis route uses [`.claude-plugin/marketplace.json`](./.claude-plugin/marketplace.json) and [`.claude-plugin/plugin.json`](./.claude-plugin/plugin.json) declared at the root of this repo.\n\n---\n\n## 🌐 MCP server (for Claude Desktop · Cursor · Cline · Continue · Zed · any MCP client)\n\n\u003e **For everyone NOT on Claude Code CLI.** The methodology corpus is also exposed as an MCP server (`mcp-server/`) so it is reachable from any client that speaks the Model Context Protocol — Claude Desktop, Cursor, Cline, Continue, Zed, OpenAI Responses API with the `openai-mcp` bridge, custom LangChain/LlamaIndex agents, etc.\n\n**Resources exposed**: `requirements://skill`, `requirements://reference/{name}`, `requirements://example/{name}`, `requirements://catalog`.\n\n**Tools exposed**: `list_references()`, `list_examples()`, `list_hard_rules()`, `validate_user_story(title, bdd?)`, `validate_acceptance_criterion(text)`.\n\nQuick start:\n\n```bash\ngit clone https://github.com/seekdevcore/sk-requirements-engineering-theskill.git\ncd sk-requirements-engineering/mcp-server\nuv sync\nuv run requirements-engineering-mcp        # boots on stdio\n```\n\nFull setup with copy-pasteable config blocks for Claude Desktop, Cursor, Cline, Continue, Zed, and Claude Code CLI in [**`mcp-server/README.md`**](./mcp-server/README.md).\n\n---\n\n## 🎯 When to invoke this skill\n\nInvoke when you (or Claude on your behalf) are doing:\n\n- **First contact with a project (mandatory first action)** — the moment the skill is applied to a folder, it auto-analyzes the project and **detects/builds the on-disk structure** (`docs/requirements/` + `docs/backlog/` + ADRs) before any other work, including **migrating projects from older skill versions** that left a loose `REQUISITOS*.md` with no traceability spine (see [`SKILL.md §0`](./SKILL.md))\n- **Requirements discovery** — interviews, surveys, brainstorming, ethnography, document analysis, stories and scenarios\n- **Specification** — building a hierarchical backlog (Epic → Feature [+ description + ACs] → User Story [+ BDD] → Task)\n- **User Stories with BDD** — writing `Given / When / Then` that bridges requirement and executable test\n- **Acceptance Criteria** — declarative testable rules per feature (with the `[...]` convention for sub-rules)\n- **Estimation** — Story Points + Planning Poker (Fibonacci scale)\n- **Validation** — Sommerville's 5 checks + Falbo's 7 dimensions + lo-fi/hi-fi prototypes\n- **Change management + traceability** — keeping docs ↔ code ↔ test aligned\n- **Business analysis** — BABOK v3, BPMN, AS-IS / TO-BE, MoSCoW, RICE\n- **Professional ethics** — *\"SBC\"* 002/2024 Code applied to privacy, ML/AI, inclusion, system decommissioning\n\n**Do not invoke for pure code implementation.** Requirements Engineering covers the stage **before** (discovering what to build) and **after** (validating that what was built is correct) — not the middle.\n\n---\n\n## 🗂 Repository structure\n\n```\nengenharia-de-requisitos/\n├── SKILL.md                       ← entry point + usage protocol (map) — en-CA\n├── README.md                      ← this file — en-CA\n├── LICENSE                        ← CC BY-SA 4.0\n├── CHANGELOG.md                   ← version history — en-CA\n├── CONTRIBUTING.md                ← how to contribute (7-section operational guide)\n├── CODE_OF_CONDUCT.md             ← Contributor Covenant 2.1 + SBC 002/2024 cross-refs\n├── .claude-plugin/                ← Claude Code plugin marketplace manifest\n│   ├── marketplace.json\n│   └── plugin.json\n├── mcp-server/                    ← MCP server for Claude Desktop / Cursor / Cline / etc.\n│   ├── src/requirements_engineering_mcp/\n│   │   ├── __init__.py\n│   │   └── server.py              ← FastMCP — Resources + Tools wrapping the corpus\n│   ├── pyproject.toml             ← uv project (mcp[cli]\u003e=1.2.0)\n│   ├── .python-version            ← 3.12\n│   └── README.md                  ← full client-config docs (Claude Desktop, Cursor, etc.)\n├── .github/\n│   ├── workflows/\n│   │   ├── quality.yml            ← CI: markdown-lint + link-check + yaml-schema + actionlint\n│   │   └── sync-upstream.yml      ← fork-only: auto-sync with upstream every 30 min\n│   ├── PULL_REQUEST_TEMPLATE.md\n│   └── ISSUE_TEMPLATE/            ← bug-or-fix, content-proposal, question-or-clarification\n├── .markdownlint.json             ← tuned config (8 rules disabled/relaxed, all documented inline)\n├── .lycheeignore                  ← 12 URL patterns intentionally skipped (rate-limited / bot-blocked)\n├── .yamllint.yml                  ← YAML lint config for .github/ schema\n├── assets/                        ← hero banner + visual assets (pt-BR diagram)\n│   └── banner.png\n├── translations/\n│   └── pt-BR/                     ← full pt-BR copy of all content\n│       ├── SKILL.md\n│       ├── README.md\n│       ├── CHANGELOG.md\n│       ├── references/            (same files as below, in pt-BR)\n│       └── examples/              (same files as below, in pt-BR)\n├── references/                    ← canonical detail (loaded on demand)\n│   ├── 01-fundamentos.md          (FR vs NFR, stakeholders, feasibility, spiral, MVP+A/B)\n│   ├── 02-elicitacao.md           (6 techniques, 5W, scales, brainstorming)\n│   ├── 03-especificacao.md        (Backlog, Epic→Feature→US→AC, INVEST, multiple root Epics)\n│   ├── 04-bdd-criterios-aceitacao.md  (BDD, Three Amigos, AC vs Gherkin, [...] convention)\n│   ├── 05-estimativa.md           (Story Points, Planning Poker, velocity)\n│   ├── 05-convencoes-interpop.md  (10 hard rules: source-of-truth document, naming, [...], etc.)\n│   ├── 06-validacao.md            (5 checks + 7 dimensions + prototypes)\n│   ├── 07-mudanca-rastreabilidade.md  (change management, RTM, enduring vs volatile requirements)\n│   ├── 08-analista-negocios.md    (BABOK, AS-IS/TO-BE, MoSCoW, RICE, Kano)\n│   ├── 09-etica-sbc.md            (SBC 002/2024 Code applied to RE)\n│   ├── 10-estrutura-projeto.md    (on-disk structure: requirements/+backlog/+specs/+two-tier ADRs; detect→create→reorganize; LEGACY-MONOLITH migration)\n│   ├── 11-ears.md                 (EARS — optional precision layer; 5 patterns EN/pt-BR; RF→EARS→CA→Gherkin)\n│   ├── 13-confiabilidade-seguranca.md  (dependability \u0026 security RNF — reliability/safety/security/resilience)\n│   └── integrations/              (per-integration docs — one .md per tool integration)\n│       ├── README.md              (integrations index → doc · adapter · validator)\n│       ├── sdd-interop.md         (optional SDD bridge — OpenSpec/Spec Kit crosswalk; check_projection_drift)\n│       └── openproject.md         (optional OpenProject bridge — backlog → Type/ID/Subject/Priority Excel sync)\n├── assets/\n│   ├── scaffold-structure.sh      (detect → create → reorganize scaffolder; GREENFIELD/HAS-STRUCTURE/LOOSE-FILES/LEGACY-MONOLITH)\n│   ├── integrations/              (per-integration adapters)\n│   │   ├── project-to-sdd.sh           (project docs/ → OpenSpec/Spec Kit, preserving [RF-NN]; pairs with check_projection_drift)\n│   │   └── project-to-openproject.py   (project docs/backlog/ → OpenProject work packages; CSV + XLSX)\n│   └── templates/                 (generic, adaptive template tree the scaffolder materializes)\n└── examples/\n    ├── caso-controle-dopagem.md         (real CNPq case — *\"ABCD\"*/*\"COB\"*)\n    ├── caso-interpop-moderacao.md       (Interpop project case — ban hierarchy)\n    ├── template-backlog-openproject.md  (full worked backlog template)\n    ├── template-documento-requisitos.md (IEEE 830 / Wiegers / Sommerville template)\n    └── template-user-story.feature      (Gherkin pt-BR ready-to-copy)\n```\n\n\u003e **Note on `references/` and `examples/` filenames**: the filenames are kept in pt-BR for backward compatibility with projects that already reference them (e.g., *\"Interpop\"*). Their **internal content was translated to en-CA in v1.2.0**. The verbatim pt-BR snapshot remains reachable at `translations/pt-BR/`.\n\n**Usage pattern**: `SKILL.md` is a map (§0 mandatory first-run structure check, then §1–§10) with links to detail. You read `SKILL.md` to locate the answer; you read a `reference` only when you need full detail on that topic.\n\n---\n\n## 👩‍🏫 About the source instructor\n\nThe course material that constitutes the primary corpus of this skill — *\"IFPB\"* ERS (*\"Engenharia de Requisitos de Software\"* / Software Requirements Engineering) — was created and taught by **Prof. Dr. *\"Juliana Dantas Ribeiro Viana de Medeiros\"*** ([Lattes CV](http://lattes.cnpq.br/9730254173461923) · [ORCID 0000-0001-8387-4616](https://orcid.org/0000-0001-8387-4616)).\n\nHer credentials make this skill content **academically and industrially grounded**, not a generic summary:\n\n### Academic credentials\n\n- **Ph.D. in Computer Science / Software Engineering** — *\"Universidade Federal de Pernambuco\"* (UFPE), 2017\n- **Doctoral thesis**: *\"An approach to support the Requirements Specification in Agile Software Development\"* — **the exact subject of this skill**\n- **Doctoral sandwich period**: *\"Universidade Nova de Lisboa\"* (UNL, Portugal), 2016 — advised by Miguel Goulão (Portugal) and Carla Schuenemann\n- Funded by the **BRAZILEUROPE MUNDUS (BEMUNDUS)** Erasmus Mundus scholarship programme\n- **M.Sc. in Computer Science** — UFPE, 2001 (thesis on ISO 9001:2000 in software companies; *\"CNPq\"* scholarship)\n- **B.Sc. in Computer Science** — *\"Universidade Federal da Paraíba\"* (UFPB), 1997\n\n### Active research lines (relevant to this skill)\n\n1. **Requirements Engineering in Agile Projects** (since 2014) — direct base of this skill\n2. Agile software development\n3. *\"Sistema de Informação para Controle de Dopagem\"* (*\"CNPq\"* DTI-A, 2014-2015 — **origin of the *\"Controle de Dopagem\"* worked example** in `examples/caso-controle-dopagem.md`)\n4. BPM (Business Process Management) automation\n\n### Industrial experience (20+ years)\n\n- ***\"DATAPREV\"*** (Federal Data Processing Service for Social Security) — IT Analyst, project manager of *\"Ministério do Trabalho\"*'s *\"Plano Nacional de Qualificação\"* (2006–2013, public competition entry)\n- ***\"CESAR\"*** (*\"Centro de Estudos e Sistemas Avançados do Recife\"*) — Project Manager (2005–2006)\n- ***\"CAGEPA\"*** (*\"Paraíba\"* state water utility) — Systems Analyst (2005–2006, public competition entry)\n- ***\"Ministério Público da Paraíba\"*** — Software Development Consultant (2002–2003)\n- ***\"Prefeitura Municipal de João Pessoa/PB\"*** — Project Manager / Lead Analyst (1997–2005, including *\"IPTU\"*/*\"ITBI\"*/*\"Taxa de Lixo\"* tax systems, *\"Sistema de Cadastro Mercantil\"*, *\"Sistema Plano Plurianual e Orçamentário\"*)\n- Past collaborations with ***\"Multilaser\"***, ***\"CPM Braxis\"***\n\n### Faculty position\n\n- ***\"Professor Efetivo\"* (tenured), *\"Dedicação Exclusiva\"*** at ***\"IFPB Campus João Pessoa\"*** since 2006 — entered through public competition, **first place**\n- Active researcher at the ***\"EMBRAPII\"*** (*\"Empresa Brasileira de Pesquisa e Inovação Industrial\"*) hub at *\"IFPB\"*\n- ***\"CNPq\"* DTI-A** researcher (*\"Desenvolvimento Tecnológico e Industrial\"*, Category A)\n- Faculty member at ***\"Universidade Federal de Campina Grande\"*** (UFCG) since 2020\n- Has supervised 50+ undergraduate students, 3 specialization students, 5+ undergraduate research students (*\"IC\"*), and is currently co-supervising 1 Ph.D. candidate and 10 *\"ICs\"*\n\n### Pedagogical resources beyond the *\"IFPB\"* course\n\n- **PMBOK** certification (Qualiti, 2005)\n- Coordinator of multiple ongoing research repositories: *\"Boas Práticas em Processos de Desenvolvimento de Software\"*, *\"Práticas em Gerenciamento de Projetos de Software\"*, *\"Ambiente de Boas Práticas Reconfiguráveis em Engenharia de Software\"*\n\n**This skill exists because Prof. Juliana made her course material publicly available for educational use.** Any improvements, translations, or derivations should preserve attribution to her authorship of the original corpus (per the CC BY-SA 4.0 license).\n\n\u003e **Citing the source material in academic work**: Medeiros, J. D. R. V. de. *Engenharia de Requisitos de Software* [course material, lectures 0–10]. *\"Instituto Federal de Educação, Ciência e Tecnologia da Paraíba\"* (*\"IFPB\"*), Campus *\"João Pessoa\"*, 2025. Available at her *\"IFPB Campus João Pessoa\"* Google Classroom; see also her Lattes CV at http://lattes.cnpq.br/9730254173461923.\n\n---\n\n## 📚 Sources (corpus that fed the skill)\n\nBuilt from the complete course material of **ERS — Requirements Engineering** at ***\"IFPB Campus João Pessoa\"*** (Prof. Dr. *\"Juliana Dantas Ribeiro Viana de Medeiros\"* — see [About the source instructor](#-about-the-source-instructor) above), complemented by the canonical bibliography:\n\n- **Sommerville, I.** *Software Engineering*, 10th ed. Pearson 2019 (Ch. 4 read integrally)\n- **Pressman, R.** *Software Engineering: A Practitioner's Approach*, 9th ed. McGraw-Hill 2021\n- **Wiegers, K. \u0026 Beatty, J.** *Software Requirements*, 3rd ed. Microsoft Press\n- **Cohn, M.** *User Stories Applied*, 2004\n- **Robertson, S. \u0026 Robertson, J.** *Mastering the Requirements Process* (VOLERE method)\n- **Hull, E., Jackson, K., Dick, J.** *Requirements Engineering*, 4th ed. Springer\n- **Falbo, R. A.** Lecture notes — UFES\n- **IIBA.** *BABOK Guide* v3\n- ***\"SBC\"*.** Resolution 002/2024 — Code of Ethics and Professional Conduct\n- **Valente, M. T.** *Engenharia de Software Moderna* (engsoftmoderna.info, MVP + A/B testing)\n\n*\"IFPB\"* lectures processed (in order):\n\n- LECTURE 0 — Course presentation\n- LECTURE 01 — Introduction to RE (real cases: $500M *\"Citibank\"*, Boeing 737 MAX, *\"INSS\"*, *\"IPTU SP\"*)\n- LECTURE 02 — RE process + FR vs NFR\n- LECTURE 03 — Real *\"CNPq\"* *\"Controle de Dopagem\"* case (full execution)\n- LECTURE 04 — Elicitation via Interviews\n- LECTURE 05 — Elicitation via Questionnaire + Brainstorming\n- LECTURE 06 — Elicitation via Ethnography + Document Analysis\n- LECTURE 07 — Specification: Initial backlog (OpenProject)\n- LECTURE 08 — Specification: Acceptance Criteria\n- LECTURE 09 — Specification: User Stories (BDD integrated)\n- LECTURE 09.2 — Sizing estimation with User Story Points (Planning Poker)\n- LECTURE 10 — Validation through interface prototypes\n\n---\n\n## 📖 Vocabulary (pt-BR ↔ en-CA glossary)\n\nThis skill uses idiomatic English terminology for general technical concepts, but **preserves Brazilian acronyms** (RF, RNF, G, CA, US, EP, F, T, TX) for visual identity and backward compatibility with existing projects (*\"Interpop\"*, *\"SIRA\"*, *\"Controle de Dopagem\"*).\n\n| pt-BR (term) | en-CA (term) | Acronym (preserved) |\n|---|---|---|\n| Engenharia de Requisitos | Requirements Engineering | RE |\n| Requisito Funcional | Functional Requirement (FR) | `RF` |\n| Requisito Não Funcional | Non-Functional Requirement (NFR) | `RNF` |\n| Critério de Aceitação | Acceptance Criterion (AC) | `CA` |\n| História de Usuário | User Story | `US` |\n| Regra de Negócio | Business Rule (BR) | `G` |\n| Épico / Epic | Epic | `EP` |\n| Funcionalidade | Feature | `F` |\n| Tarefa | Task | `T` |\n| Tarefa Transversal | Cross-cutting Task | `TX` |\n| Backlog do produto / da sprint | Product Backlog / Sprint Backlog | — |\n| DADO / QUANDO / ENTÃO | Given / When / Then | — |\n| Funcionalidade: (Gherkin) | Feature: (Gherkin) | — |\n| Cenário: (Gherkin) | Scenario: (Gherkin) | — |\n\n\u003e **Why the acronyms are preserved**: real projects already use `EP-NN`, `F-NN`, `CA-NN`, `USNN.M`, `TNN.M.K`, `TX-NN`, `G-NN` in OpenProject, in commit messages, in code comments, and in pull-request titles. Renumbering them to `EP/FT/AC/US/TK/XT/BR` would break years of traceability for no real gain. The English terms are used in prose; the acronyms remain pt-BR-rooted.\n\nCucumber, Behave, SpecFlow, and Behat support localized Gherkin natively. To author `.feature` files in pt-BR, add `# language: pt` at the top; for en-CA the default is sufficient.\n\n---\n\n## 🤝 Contributing\n\nPull requests welcome — especially for:\n\n1. Additional real-world worked examples (case studies from other domains: fintech, govtech, healthtech, SaaS multi-tenant)\n2. New `.feature` template variants per stack (pytest-bdd, behave, cucumber-js, cucumber-playwright, SpecFlow, Behat)\n3. Tooling integration scaffolds (Linear, Jira, Notion, GitHub Issues, Plane)\n4. Additional language translations (es, fr, de, it, etc.) under `translations/\u003cbcp-47-tag\u003e/`\n\nWhen contributing, follow the same conventions documented in `references/05-convencoes-interpop.md` (10 hard rules: source-of-truth document, naming without infinitives, no technical terms in non-Task artifacts, grouped ACs with `[...]` convention, etc.).\n\nFor en-CA translation contributions, preserve:\n\n- **All pt-BR domain terms** in *italic + quotes* (institutions, organizations, government systems, project codenames, regulatory frameworks)\n- **All pt-BR acronyms** (`RF`, `RNF`, `G`, `CA`, `US`, `EP`, `F`, `T`, `TX`) — do not renumber to English\n- **Cross-references** between files (when a reference points to `references/05-convencoes-interpop.md`, the link stays valid because the filename is preserved)\n\n---\n\n## 📄 License\n\nThis skill content is licensed under **[Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/)**.\n\nYou are free to:\n\n- **Share** — copy and redistribute in any medium or format\n- **Adapt** — remix, transform, and build upon the material for any purpose, even commercially\n\nUnder the following terms:\n\n- **Attribution** — give appropriate credit to **Prof. Dr. *\"Juliana Dantas Ribeiro Viana de Medeiros\"*** as author of the original course material (see [About the source instructor](#-about-the-source-instructor) for the academic citation format), and indicate if changes were made\n- **ShareAlike** — distribute your contributions under the same license\n\nSee [`LICENSE`](./LICENSE) for the full legal code.\n\n---\n\n## 🏷 Maintainer\n\nPublished by [**Seek**](https://github.com/seekdevcore) (`seekdevcore` on GitHub).\n\nOriginal author and curator: **Gabriel Marques** ([@GabeMarques-Intetsu](https://github.com/GabeMarques-Intetsu)).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseekdevcore%2Fsk-requirements-engineering-theskill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseekdevcore%2Fsk-requirements-engineering-theskill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseekdevcore%2Fsk-requirements-engineering-theskill/lists"}