Agent Skill
2/7/2026

dsr

Design Science Research Methodology for rigorous artifact development. Use this skill when: (1) Creating new tools, frameworks, or systems that solve real problems (2) Need structured approach to build-evaluate-iterate cycles (3) Want scientific rigor in development process (4) Evaluating artifacts against clear criteria (5) Documenting research contributions systematically Based on Hevner et al. (2004) and Peffers et al. (2007) - foundational DSR papers.

A
anderson
0GitHub Stars
1Views
npx skills add anderson-ufrj/prompt-engineering

SKILL.md

Namedsr
DescriptionDesign Science Research Methodology for rigorous artifact development. Use this skill when: (1) Creating new tools, frameworks, or systems that solve real problems (2) Need structured approach to build-evaluate-iterate cycles (3) Want scientific rigor in development process (4) Evaluating artifacts against clear criteria (5) Documenting research contributions systematically Based on Hevner et al. (2004) and Peffers et al. (2007) - foundational DSR papers.

name: dsr description: | Design Science Research Methodology for rigorous artifact development. Use this skill when: (1) Creating new tools, frameworks, or systems that solve real problems (2) Need structured approach to build-evaluate-iterate cycles (3) Want scientific rigor in development process (4) Evaluating artifacts against clear criteria (5) Documenting research contributions systematically

Based on Hevner et al. (2004) and Peffers et al. (2007) - foundational DSR papers.

Design Science Research (DSR)

A scientific methodology for creating and evaluating IT artifacts that solve real problems.

Quick Reference

ActivityQuestionOutput
1. ProblemWhat problem needs solving?Problem statement, motivation
2. ObjectivesWhat would a solution look like?Requirements, success criteria
3. DesignHow do we build it?Artifact architecture
4. DemonstrationDoes it work?Working prototype
5. EvaluationHow well does it work?Metrics, comparison
6. CommunicationWho needs to know?Documentation, papers

The DSRM Process Model

┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
│ 1.       │   │ 2.       │   │ 3.       │   │ 4.       │   │ 5.       │   │ 6.       │
│ Problem  │──►│Objectives│──►│ Design & │──►│ Demon-   │──►│ Evaluate │──►│Communi-  │
│ Identify │   │          │   │ Develop  │   │ strate   │   │          │   │ cate     │
└──────────┘   └──────────┘   └──────────┘   └──────────┘   └──────────┘   └──────────┘
     │                             ▲              │              │
     │                             │              └──────────────┘
     │                             │                 (iterate)
     └─────────────────────────────┘
              (refine problem understanding)

Activity 1: Problem Identification & Motivation

Purpose

Define the research problem and justify the value of a solution.

Questions to Answer

  • What is the problem?
  • Why is it important?
  • Who is affected?
  • What is the current state?
  • What are the consequences of not solving it?

Template

<problem_identification>
  <problem_statement>
    [Clear, concise statement of the problem]
  </problem_statement>

  <importance>
    [Why does this matter? Quantify if possible]
  </importance>

  <stakeholders>
    [Who is affected by this problem?]
  </stakeholders>

  <current_state>
    [How is this currently handled? What are the limitations?]
  </current_state>

  <consequences>
    [What happens if we don't solve this?]
  </consequences>
</problem_identification>

Example

<problem_identification>
  <problem_statement>
    Human-AI collaboration lacks personalization, leading to repetitive
    context-setting and suboptimal interactions.
  </problem_statement>

  <importance>
    Developers spend 15-30% of AI interaction time re-establishing context.
    This reduces productivity and leads to frustration.
  </importance>

  <stakeholders>
    - Developers using AI assistants
    - Teams adopting AI-augmented workflows
    - Organizations investing in AI tools
  </stakeholders>

  <current_state>
    - Generic system prompts used for all users
    - No persistent memory of user preferences
    - Context lost between sessions
  </current_state>

  <consequences>
    - Continued inefficiency in human-AI collaboration
    - Slower AI adoption due to friction
    - Missed potential of personalized AI assistance
  </consequences>
</problem_identification>

Activity 2: Define Objectives of a Solution

Purpose

Infer objectives from the problem definition and knowledge of what is possible.

Questions to Answer

  • What would an ideal solution do?
  • What are the success criteria?
  • How will we know if we've succeeded?
  • What constraints must we respect?

Template

<objectives>
  <ideal_solution>
    [Description of what success looks like]
  </ideal_solution>

  <success_criteria>
    <criterion metric="[metric_name]">
      [Specific, measurable criterion]
    </criterion>
    <!-- Add more criteria -->
  </success_criteria>

  <constraints>
    <constraint type="technical">[constraint]</constraint>
    <constraint type="resource">[constraint]</constraint>
    <constraint type="time">[constraint]</constraint>
  </constraints>

  <non_goals>
    [What are we explicitly NOT trying to achieve?]
  </non_goals>
</objectives>

Objective Types

TypeDescriptionExample
QuantitativeMeasurable numbers"Reduce context-setting time by 50%"
QualitativeObservable improvements"Users report higher satisfaction"
ComparativeBetter than alternatives"Outperform baseline approach"
SatisficingMeet minimum threshold"Achieve 80% accuracy"

Activity 3: Design & Development

Purpose

Create the artifact - constructs, models, methods, or instantiations.

Artifact Types

TypeDescriptionExamples
ConstructsVocabulary, conceptsDMMF dimensions, pattern names
ModelsAbstractions, representationsArchitecture diagrams, frameworks
MethodsAlgorithms, processesWorkflow patterns, evaluation procedures
InstantiationsWorking systemsImplemented software, prototypes

Template

<design>
  <artifact_type>[construct|model|method|instantiation]</artifact_type>

  <architecture>
    [High-level design of the artifact]
  </architecture>

  <components>
    <component name="[name]">
      <purpose>[what it does]</purpose>
      <interface>[how to interact with it]</interface>
    </component>
  </components>

  <design_decisions>
    <decision>
      <choice>[what was decided]</choice>
      <rationale>[why this choice]</rationale>
      <alternatives>[what else was considered]</alternatives>
    </decision>
  </design_decisions>

  <theoretical_foundation>
    [What theories/prior work inform this design?]
  </theoretical_foundation>
</design>

Design Principles (Hevner's Guidelines)

  1. Artifact Focus - Produce something concrete and usable
  2. Problem Relevance - Solve a real problem that matters
  3. Rigor - Apply appropriate theoretical foundations
  4. Search Process - Iterate through solution space systematically

Activity 4: Demonstration

Purpose

Demonstrate use of the artifact to solve the problem.

Demonstration Methods

MethodUse CaseExample
Proof of ConceptShow feasibilityMinimal working implementation
Case StudyReal-world applicationApply to actual project
SimulationControlled testingRun with synthetic data
ExperimentComparative evaluationA/B test with alternatives

Template

<demonstration>
  <method>[proof_of_concept|case_study|simulation|experiment]</method>

  <context>
    [Where/how is the artifact being demonstrated?]
  </context>

  <scenario>
    <input>[what goes in]</input>
    <process>[what happens]</process>
    <output>[what comes out]</output>
  </scenario>

  <observations>
    [What did we observe during demonstration?]
  </observations>

  <artifacts_produced>
    [What tangible outputs were created?]
  </artifacts_produced>
</demonstration>

Activity 5: Evaluation

Purpose

Observe and measure how well the artifact supports a solution.

Evaluation Methods

CategoryMethodDescription
ObservationalCase StudyIn-depth analysis of real use
ObservationalField StudyNatural environment observation
AnalyticalStatic AnalysisExamine structure/properties
AnalyticalArchitecture AnalysisEvaluate design qualities
ExperimentalControlled ExperimentIsolate variables
ExperimentalSimulationModel-based testing
TestingFunctional TestingDoes it work correctly?
TestingStructural TestingCode coverage, paths
DescriptiveInformed ArgumentLogical reasoning
DescriptiveScenariosDetailed use cases

Template

<evaluation>
  <method>[evaluation method]</method>

  <criteria>
    <criterion name="[name]" weight="[0-1]">
      <definition>[what does this measure?]</definition>
      <measurement>[how do we measure it?]</measurement>
      <threshold>[what counts as success?]</threshold>
    </criterion>
  </criteria>

  <results>
    <result criterion="[name]">
      <score>[actual measurement]</score>
      <evidence>[supporting data]</evidence>
    </result>
  </results>

  <analysis>
    [Interpretation of results]
  </analysis>

  <limitations>
    [What are the limitations of this evaluation?]
  </limitations>

  <improvements>
    [What could be improved based on evaluation?]
  </improvements>
</evaluation>

Evaluation Checklist

  • Are criteria aligned with objectives?
  • Is evidence quantifiable where possible?
  • Are limitations acknowledged?
  • Is comparison to alternatives included?
  • Are threats to validity addressed?

Activity 6: Communication

Purpose

Communicate the problem, artifact, and results to relevant audiences.

Audiences

AudienceFocusFormat
ResearchersMethodology, rigor, contributionAcademic paper
PractitionersHow to use, benefitsDocumentation, tutorials
ManagementBusiness value, ROIExecutive summary
CommunityAccessibility, adoptionBlog posts, talks

Template

<communication>
  <audience>[target audience]</audience>

  <key_messages>
    <message priority="1">[most important takeaway]</message>
    <message priority="2">[second takeaway]</message>
    <message priority="3">[third takeaway]</message>
  </key_messages>

  <contribution_type>
    [artifact|foundation|methodology]
  </contribution_type>

  <artifacts>
    <artifact type="[type]" location="[where]">
      [description]
    </artifact>
  </artifacts>

  <reproducibility>
    [How can others reproduce/build on this work?]
  </reproducibility>
</communication>

Hevner's 7 Guidelines Checklist

Use this to validate your DSR project:

#GuidelineQuestionStatus
1Design as ArtifactDid we create a concrete artifact?[ ]
2Problem RelevanceDoes it solve a real problem?[ ]
3Design EvaluationDid we rigorously evaluate it?[ ]
4Research ContributionsWhat's new/novel?[ ]
5Research RigorDid we apply appropriate methods?[ ]
6Design as SearchDid we explore the solution space?[ ]
7CommunicationDid we share with relevant audiences?[ ]

Entry Points

You can enter the DSRM process at different points:

Entry PointTriggerStart At
Problem-CenteredNew problem identifiedActivity 1
Objective-CenteredIndustry/research needActivity 2
Design-CenteredExisting artifact to extendActivity 3
Client-CenteredConsulting engagementActivity 4

Iteration Patterns

Pattern 1: Linear

1 → 2 → 3 → 4 → 5 → 6

Use when: Problem is well-understood, single iteration sufficient.

Pattern 2: Evaluation Loop

1 → 2 → 3 → 4 → 5 → (improvements) → 3 → 4 → 5 → 6

Use when: Iterative refinement needed based on evaluation.

Pattern 3: Problem Refinement

1 → 2 → 3 → 4 → (new insights) → 1 → 2 → 3 → 4 → 5 → 6

Use when: Demonstration reveals problem was misunderstood.

Pattern 4: Continuous

1 → 2 → 3 → 4 → 5 → 6 → (feedback) → 1 ...

Use when: Ongoing research program with multiple cycles.


Integration with Cognitive Workflows

DSR activities can use cognitive workflow patterns:

DSR ActivityUseful Patterns
Problem IDParallel - Multiple stakeholder perspectives
ObjectivesChain - Problem → Constraints → Criteria
DesignOrchestrator - Break down into design tasks
DemonstrationRoute - Different demo paths per audience
EvaluationEvaluator-Optimizer - Iterative refinement
CommunicationParallel - Different audience versions

References

  • Hevner, A. R., March, S. T., Park, J., & Ram, S. (2004). Design Science in Information Systems Research. MIS Quarterly, 28(1), 75-105.
  • Peffers, K., Tuunanen, T., Rothenberger, M. A., & Chatterjee, S. (2007). A Design Science Research Methodology. JMIS, 24(3), 45-77.

Evidence: evidence/patterns/004-design-science-research-methodology.md

Skills Info
Original Name:dsrAuthor:anderson