I like brian d foy's Random Adventures Note Taking Style

Mon, 16 Mar 2026 04:30:31 -0700

I like brian d foy’s Random Adventures Note Taking Style

In contrast to my own “literature” note: unitycoin clean code uncle bob lesson 6 agile

I like, Perl trainer and writer, brian d foy – Random Adventures for his summary note of “Coding Better World Together” - Clean Code Lesson 6 . His notes are concise and practical, capturing the core ideas without unnecessary detail.

In Lesson 6, Robert C. Martin explains how many software projects suffer from classic symptoms of mismanagement: delivering the wrong product, producing low-quality software, or shipping late. These problems often arise from unrealistic expectations captured in the so-called “Iron Cross” of project management, trying to make a project good, fast, cheap, and done at the same time, even though in practice you can usually optimize for only three.

Agile practices help teams confront reality early through data and transparency. Techniques such as story points and burn-down charts provide a measurable way to track progress. By putting these charts where the team can see them, everyone shares the same understanding of the project’s state.

One striking idea from Uncle Bob is that “the purpose of Agile is to destroy hope.” That sounds pessimistic at first, but the real meaning is about exposing problems as early as possible. Instead of pretending everything is fine until the deadline arrives, Agile reveals how “messed up” a project might be while there is still time to correct course.

The lesson also emphasizes small, focused teams working on small pieces of functionality. Estimation becomes easier when the team maintains a consistent reference task for assigning story points. Ultimately, a project is not considered finished when every planned task is completed, but when there is nothing valuable left to do.

These ideas reinforce the core Agile mindset: transparency, early feedback, and incremental progress are essential for aligning software production with delivery expectations.

UnityCoin - Clean Code - Uncle Bob / Lesson 6 - Agile

Mon, 20 Oct 2025 00:00:00 +0000

Literature note: UnityCoin - Clean Code - Uncle Bob / Lesson 6 - Agile Solutions for Balancing Deadlines and Software Quality

Source highlights: Clean Code - Uncle Bob / Lesson 6 (Highlights)

Summary: Agile isn’t about speed… It’s about visibility. Agile replaces hope with data so teams can manage reality instead of wishful thinking; to clarify, Agile is a feedback system for managing uncertainty - not a process for going faster.

Key Ideas

Agile’s purpose: get the bad news fast, not to move faster. Shorter iterations - higher visibility resolution.
Every project balances the Iron Cross: good, fast, cheap, done - you can’t have all four.
Velocity charts and burn-down charts are the backbone of real Agile - no data, no management.
Quality drives speed: “You go fast by going well.”
Don’t let a tool or process get in the way of getting impactful work done.
Large-scale Agile requires many small Agile teams working in parallel - not a single “Agile in the large” process.
Strong communication prevents waste, misalignment, and rework.

Chapters

How do you manage a software project?

(See highlights and initial reflections)

Software project management is notoriously hard - often done “badly” or through “hope and prayer”.
Mismanagement leads to wrong products, low quality, missed deadlines, and burnout.
The Iron Cross defines constraints: good, fast, cheap, done - you can’t have all four.
Effective managers adjust the knobs (quality, cost, schedule, scope) using frequent feedback and short iteration cycles.
Agile exists to improve feedback and communication, reducing guesswork.
- The goal isn’t to hit a fixed plan - it’s to steer toward the best achievable outcome.

Finding the optimum solution / Data

(See highlights and initial reflections)

Data drives success; without it, management is blind.
Use metrics to manage toward the best achievable outcome across quality, cost, speed, and scope.
Two key tools:
- Velocity Chart: shows how much work is completed per week/iteration.
- Burn-down Chart: shows how much work remains to reach the next major milestone.
These visuals allow teams and managers to predict progress transparently.
Requirements should never freeze - Agile welcomes change as understanding improves.
Estimates ≠ promises; treat them as evolving signals.
The goal of Agile: produce reliable data early so the team can manage reality.

What is the first thing know about project / The Management Paradox

(See highlights and initial reflections)

The first thing known in any project is the date, often fixed by business needs; however, requirements are fluid - customers refine what they want through iteration.
Agile solves this by allowing requirements to evolve while maintaining time-boxed delivery.
Teams continuously replan priorities, focusing on core features first and pushing less-critical items to future iterations.
- If every feature is “critical,” none of them are - prioritize what matters.
Frequent show-and-tell sessions keep customer expectations aligned with progress.
- Customers rarely know what they truly want until they see a working product.
- Agile embraces this uncertainty by iterating quickly and showing progress often.

The Waterfall Model

(See highlights and initial reflections)

Traditional Waterfall assumes phases (analysis, design, implementation) are sequential and “done”.
In reality, analysis and design are continuous, not binary.
Software differs from physical engineering - it’s adaptable and should evolve.
Freezing requirements too early forces teams to “hack in” changes later, creating instability and technical debt.
Waterfall often fails because it resists feedback and delays learning until it’s too late.

Iterative Development / Calculate Day

(See highlights and initial reflections)

“Runaway process inflation” happens when teams respond to failure by adding more process instead of more feedback.
Iterative development starts with Iteration 0 - capture lightweight requirements and draft user stories, leaving details to emerge over time.
- Gather rough requirements and create simple user stories - refine later.
Each iteration provides real data about progress, risks, and estimates.
The focus shifts from predicting the future to learning as early as possible.

The Control Knobs of project mgt

(See highlights and initial reflections)

The four adjustable controls:
1. Schedule
2. Staff
3. Quality
4. Scope
Adding people rarely helps - it initially slows progress (Brooks’s Law).
Lowering quality for speed causes rework and collapse - “You go fast by going well”.
Scope negotiation is the manager’s most powerful lever; trim deliverables to hit the date.
- Scope is the most flexible lever; negotiate what must ship now vs. later.
Developers hold the data, stakeholders hold the authority - in rational organizations, data should win.

Short Cycles / Agile Software Development Practices / Extreme Programming

(See highlights and initial reflections)

Agile development, particularly Extreme Programming (XP), emphasizes short cycles to uncover problems (“bad news”) as early as possible. The goal of Agile isn’t speed, but early feedback and adaptability.

You can’t fix scope, date, quality, and cost all at once (“the Iron Cross”). The best way to manage uncertainty is to work iteratively, learning and adjusting each cycle; that is, short cycles expose tradeoffs early.
Agile’s purpose: get the bad news fast, not to move faster.
Scrum without engineering discipline (testing, refactoring, clean code) leads to Flaccid Scrum - progress slows and quality decays: a process framework without the technical rigor needed for success.
- Extreme Programming (XP) (testing, refactoring, clean design) keep Scrum sustainable.
XP structure of practices
- Outer (Green) Ring - Business-facing (Scrum-level): focus on what is being built and why, ensuring that the software actually delivers value to the customer or stakeholder.
  - Whole Team: Business and technical people work together.
  - Acceptance Tests: Define done-ness in terms the customer understands.
  - Small Releases: Deliver value and get customer feedback early.
  - Planning Game: Balance business priorities with technical estimates.
- Middle (Blue) Ring: Team behavior
  - Continuous Integration: Team members frequently integrate and test their code together, ensuring shared ownership and rapid feedback.
  - Metaphor: The team uses a shared “story” or metaphor to describe the system’s architecture, helping everyone (technical or not) share a common understanding.
    - Creates a common language across technical and non-technical people.
    - Helps guide design decisions - new features should “fit the metaphor”.
    - Makes the system easier to discuss and reason about.
  - Sustainable Pace: The team avoids burnout by maintaining a steady, reasonable work rhythm - no “death marches”.
  - Collective Ownership: Any developer can improve or modify any part of the code; responsibility is shared, not siloed.
- Inner (Red) Ring: Engineering (developer-specific)
  - Test-Driven Development
  - Pair Programming
  - Simple Design
  - Refactoring
- Business-facing == practices that expose progress, risk, and value to the business side (product owners, stakeholders, customers).
- Engineering-facing == practices that ensure technical excellence and delivery capability.
Agile works best for small, disciplined teams.
Large-scale Agile requires many small Agile teams working in parallel - not a single “Agile in the large” process.
Avoid process theater - when tools (e.g., Jira) become more important than outcomes.
Relative estimation (story points) enables better forecasting and ROI-based prioritization.
Projects finish not when everything’s done, but when nothing valuable remains.
Iterations never fail - even zero progress yields data for better management.
Velocity stability is the goal - steady, predictable output signals health.
- Stable velocity signals health; erratic or declining trends indicate tech debt or pressure.

Questions and Answers

(See highlights and initial reflections)

Writing extensive documentation often fails - “nobody reads it”. Favor visibility and communication instead.
Mentorship is a senior engineer’s responsibility; pairing with juniors accelerates growth for both.
- “The best way to learn something is to teach it” .
Business analysts play a crucial role - they must translate between technical and business domains.
- Effective analysts empathize with both the customer’s needs and the developer’s challenges.
- Understand and communicate both customer intent and developer constraints.
Spikes (research tasks) are valid stories - used to explore unknowns and improve estimation accuracy.

Software-Development on matt2ology Tech Journal and Blog

I like brian d foy's Random Adventures Note Taking Style