How does it handle multiple active tasks?

If the skill detects multiple in-progress leaf tasks, it will prompt the user to select the specific task the plan should be linked to.

Where does the skill look for plan files?

By default, it searches for the newest markdown file within the 'docs/plans/' directory of your repository.

Will it overwrite my existing task descriptions?

No, it retrieves the current description and appends the plan link at the end, ensuring that existing content and design links are preserved.

Does this skill create new tasks or subtasks?

No, this skill is intentionally minimalist. It only saves the link to existing tasks and does not create subtasks, branches, or todo lists.

What is the primary function of the Linking Plan skill?

The skill finds the most recent implementation plan document and adds its file path to your current task's description, ensuring documentation and work are always connected.

Linking Plan

Name: Linking Plan
Author: NoNameItem

byNoNameItem

Productivity & Workflow

Links the latest implementation plan document to your active task description for seamless project traceability.

About

The Linking Plan skill automates the crucial handoff between planning and execution by identifying the most recent implementation plan in your project and attaching its reference directly to your current task. Designed for the 'beads' task management workflow, it eliminates manual copy-pasting of file paths, ensures documentation is always linked to active work, and carefully preserves existing metadata like design links. It is a focused, high-reliability utility that maintains project organization without introducing unnecessary side effects or scope creep.

Key Features

0 GitHub stars
Automatically identifies the newest markdown plan in docs/plans/
Detects and resolves conflicts between multiple in-progress tasks
Appends plan references while preserving existing design links
Streamlines the transition from planning to implementation phases
Verifies task status to ensure plans are linked to active work

Use Cases

Linking a newly finalized implementation plan to a task before starting code changes
Standardizing the post-planning workflow for teams using the beads task system
Maintaining clear traceability between project documentation and task descriptions

About

Key Features

0 GitHub stars
Automatically identifies the newest markdown plan in docs/plans/
Detects and resolves conflicts between multiple in-progress tasks
Appends plan references while preserving existing design links
Streamlines the transition from planning to implementation phases
Verifies task status to ensure plans are linked to active work

Use Cases

Linking a newly finalized implementation plan to a task before starting code changes
Standardizing the post-planning workflow for teams using the beads task system
Maintaining clear traceability between project documentation and task descriptions